Destroys a thread attributes object.

1  –  C Binding

    #include <pthread.h>

    int
    pthread_attr_destroy (
                pthread_attr_t   *attr);

2  –  Arguments

 attr

    Thread attributes object to be destroyed.

3  –  Description

    This routine destroys a thread attributes object. Call this
    routine when a thread attributes object will no longer be
    referenced.

    Threads that were created using this thread attributes object are
    not affected by the destruction of the thread attributes object.

    The results of calling this routine are unpredictable if
    the value specified by the attr argument refers to a thread
    attributes object that 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 thread
                attributes object.

5  –  Associated Routines

       pthread_attr_init()
       pthread_create()