Destroys the specified mutex attributes object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_mutexattr_destroy (
             pthread_mutexattr_t   *attr);

2  –  Arguments

 attr

    Mutex attributes object to be destroyed.

3  –  Description

    This routine destroys a mutex attributes object-that is, the
    object becomes uninitialized. Call this routine when your program
    no longer needs the specified mutex attributes object.

    After this routine is called, the Threads Library may reclaim
    the storage used by the mutex attributes object. Mutexes that
    were created using this attributes object are not affected by the
    destruction of the mutex attributes object.

    The results of calling this routine are unpredictable, if the
    attributes object specified in the attr argument does not exist.

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
                object.

5  –  Associated Routines

       pthread_mutexattr_init()