NAME    [Toc]    [Back]

     pthread_getspecific - get a thread-specific data value

SYNOPSIS    [Toc]    [Back]

     #include <pthread.h>

     void *
     pthread_getspecific(pthread_key_t key);

DESCRIPTION    [Toc]    [Back]

     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.

     pthread_getspecific()  may  be called from a thread-specific
data destructor
 function.

RETURN VALUES    [Toc]    [Back]

     The pthread_getspecific() function will return  the  threadspecific data
     value  associated with the given key.  If no thread-specific
data value is
     associated with key, then the value NULL is returned.

ERRORS    [Toc]    [Back]

     None.

SEE ALSO    [Toc]    [Back]

     pthread_key_create(3),  pthread_key_delete(3),  pthread_setspecific(3)

STANDARDS    [Toc]    [Back]

     pthread_getspecific()   conforms   to   ISO/IEC  9945-1:1996
(``POSIX'').

OpenBSD     3.6                           April      4,      1996