Documentation Archive Developer
Search
ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man Pages

 

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).



PTHREAD_GETSPECIFIC(3)   BSD Library Functions Manual   PTHREAD_GETSPECIFIC(3)

NAME
     pthread_getspecific -- get a thread-specific data value

SYNOPSIS
     #include <pthread.h>

     void *
     pthread_getspecific(pthread_key_t key);

DESCRIPTION
     The pthread_getspecific() function returns the value that is currently
     bound to the specified key, on behalf of the calling thread.

     The effect of calling pthread_getspecific() with a key value that was not
     obtained from pthread_key_create(), or after a key has been deleted with
     pthread_key_delete(), is undefined.

     pthread_getspecific() may be called from a thread-specific data destruc-tor destructor
     tor 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, the value NULL is returned.

ERRORS
     None.

SEE ALSO
     pthread_key_create(3), pthread_key_delete(3), pthread_setspecific(3)

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

BSD                              April 4, 1996                             BSD