pthread_getspecific3
Get a thread-specific data value
Usage
#include <pthread.h>
void *
pthread_getspecific(pthread_key_t key);
Library
POSIX Threads Library (libpthread, -lpthread)
Overview
The pthread_getspecific() function returns the value currently bound to the specified key on behalf of the calling thread.
The effect of calling pthread_getspecific() with a key value not obtained from pthread_key_create() or after key has been deleted with pthread_key_delete() is undefined.
The pthread_getspecific() function may be called from a thread-specific data destructor function. A call to pthread_getspecific() for the thread-specific data key being destroyed returns the value NULL, unless the value is changed (after the destructor starts) by a call to pthread_setspecific().
Return values
The pthread_getspecific() function will return the thread-specific data value associated with the given key. If no thread-specific data value is associated with key, then the value NULL is returned.
Errors
None.
Releases
80 releases since FreeBSD 2.2.7-RELEASE; the text changed 45 times.