delete a thread-specific data
function deletes a thread-specific data key previously returned by
The thread-specific data values associated with key
need not be NULL at the time that
pthread_key_delete() is called. It is the
responsibility of the application to 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
called. Any attempt to use key following the call to
pthread_key_delete() results in undefined
function is callable from within destructor functions. Destructor functions
are not invoked by
destructor function that may have been associated with
key will no longer be called upon thread exit.
If successful, the
function will return zero. Otherwise an error number will be returned to
indicate the error.
pthread_key_delete() will fail if:
- The key value is invalid.
pthread_getspecific(3), pthread_key_create(3), pthread_setspecific(3)
pthread_key_delete() conforms to
ISO/IEC 9945-1:1996 (“POSIX.1”).