NAME    [Toc]    [Back]

       pthread_key_delete - Deletes a thread-specific data key

SYNOPSIS    [Toc]    [Back]

       #include <pthread.h>

       int pthread_key_delete(
               pthread_key_t key );

LIBRARY    [Toc]    [Back]

       DECthreads POSIX 1003.1c Library (libpthread.so)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       IEEE Std 1003.1c-1995, POSIX  System  Application  Program
       Interface

PARAMETERS    [Toc]    [Back]

       Context key to be deleted.

DESCRIPTION    [Toc]    [Back]

       This  routine  deletes the thread-specific data key specified
 by the key argument, which must have been  previously
       returned by pthread_key_create(3).

       The  thread-specific  data values associated with key need
       not be NULL at the time this routine is called. The application
  must  free  any application storage or perform any
       cleanup actions for data structures related to the deleted
       key  or  associated  thread-specific  data in any threads.
       This cleanup can be done either before or after this  routine
 is called.

       Do  not attempt to use the key after calling this routine;
       this results in unpredictable behavior.

       No destructor functions are invoked by this  routine.  Any
       destructor  functions  that  may have been associated with
       key  shall  no  longer  be  called   upon   thread   exit.
       pthread_key_delete(3) can be called from within destructor
       functions.

RETURN VALUES    [Toc]    [Back]

       If an error condition  occurs,  this  routine  returns  an
       integer  value  indicating  the  type  of  error. Possible
       return values are as follows: Successful completion.   The
       key value is an invalid argument.

ERRORS    [Toc]    [Back]

       None

SEE ALSO    [Toc]    [Back]

       Functions:     pthread_exit(3),    pthread_getspecific(3),
       pthread_key_create(3)

       Manuals: Guide to DECthreads and Programmer's Guide



                                            pthread_key_delete(3)