set a thread-specific data value
POSIX Threads Library (libpthread, -lpthread)
, const void
() function associates
a thread-specific value with a key
via a previous call to
(). Different threads can
bind different values to the same key. These values are typically pointers to
blocks of dynamically allocated memory that have been reserved for use by the
The effect of calling
with a key value not obtained from
() or after
has been deleted with
() is undefined.
() function may be
called from a thread-specific data destructor function, however this may
result in lost storage or infinite loops if doing so causes non-NULL key
values to remain after [PTHREAD_DESTRUCTOR_ITERATIONS] iterations of
destructor calls have been made.
If successful, the
function will return zero. Otherwise an error number will be returned to
indicate the error.
() function will fail
- Insufficient memory exists to associate the value with the
- The key value is invalid.
() function conforms
to ISO/IEC 9945-1:1996