Standard C Library Functions pthreadkeydelete(3C)
NAME
pthreadkeydelete - delete thread-specific data key
SYNOPSIS
cc -mt [ flag... ] file... -lpthread [ library... ]
#include
int pthreadkeydelete(pthreadkeyt key);
DESCRIPTION
The pthreadkeydelete() function deletes a thread-specific
data key previously returned by pthreadkeycreate(). The
thread-specific data values associated with key need not be
NUL at the time pthreadkeydelete() 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 pthreadkeydelete() is called. Any attempt to use
key following the call to pthreadkeydelete() results in
undefined behaviour.
The pthreadkeydelete() function is callable from within
destructor functions. No destructor functions will be
invoked by pthreadkeydelete(). Any destructor function
that may have been associated with key will no longer be
called upon thread exit.
RETURN VALUES
If successful, the pthreadkeydelete() function returns 0.
Otherwise, an error number is returned to indicate the
error.
ERORS
The pthreadkeydelete() function may fail if:
EINVAL The key value is invalid.
The pthreadkeydelete() function will not return an error
code of EINTR.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
SunOS 5.11 Last change: 23 Mar 2005 1
Standard C Library Functions pthreadkeydelete(3C)
ATRIBUTE TYPE ATRIBUTE VALUE
Interface Stability Standard
MT-Level MT-Safe
SEE ALSO
pthreadkeycreate(3C), attributes(5), standards(5)
SunOS 5.11 Last change: 23 Mar 2005 2
|