FreeBSD Man Pages

pthread_getspecific(3)

NAME

     pthread_getspecific -- get a thread-specific data value

LIBRARY

     Reentrant C Library (libc_r, -lc_r)
     POSIX Threads Library (libpthread, -lpthread)
     1:1 Threading Library (libthr, -lthr)

SYNOPSIS

     #include <pthread.h>

     void *
     pthread_getspecific(pthread_key_t key);

DESCRIPTION

     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.

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.

SEE ALSO

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

STANDARDS

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

FreeBSD 5.4			 April 4, 1996			   FreeBSD 5.4

SPONSORED LINKS