set a thread-specific data value
, const void
() function associates a
thread-specific value with a key
a previous call to pthread_key_create
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 calling thread.
The effect of calling pthread_setspecific
() with a
key value not obtained from pthread_key_create
or after key
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 pthread_setspecific
will return zero. Otherwise an error number will be returned to indicate the
() will fail if:
- Insufficient memory exists to associate the value with the
- The key value is
() conforms to