set a thread-specific data value
, const void
() function associates
a thread-specific value with a key
via a previous call to
(). Different threads may
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.
() may be called from a
thread-specific data destructor function; however, this may result in lost
storage or infinite loops.
If successful, the
function will return zero. Otherwise an error number will be returned to
indicate the error.
() will fail if:
- Insufficient memory exists to associate the value with the
- The key value is invalid.
() conforms to