Destroys a previously initialized read-write lock attributes
    object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_rwlockattr_destroy (
             pthread_rwlockattr_t   *attr);

2  –  Arguments

 attr

    Address of the read-write lock attributes object to be destroyed.

3  –  Description

    This routine destroys the read-write lock attributes object
    referenced by attr; that is, the object becomes uninitialized.

    After successful completion of this routine, the results of using
    attr in a call to any routine (other than pthread_rwlockattr_
    init()) are unpredictable.

4  –  Return Values

    If an error condition occurs, this routine returns an integer
    value indicating the type of error. Possible return values are as
    follows:

    Return      Description

    0           Successful completion.
    [EINVAL]    The value specified by attr is not a valid attributes
                block.

5  –  Associated Routines

       pthread_rwlockattr_init()
       pthread_rwlock_init()