Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
PTHREAD_GETSPECIFIC(3)	    Library Functions Manual	PTHREAD_GETSPECIFIC(3)

NAME
       pthread_getspecific -- get a thread-specific data value

LIBRARY
       POSIX Threads Library (libpthread, -lpthread)

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 ob-
       tained 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.

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	14.3			 April 4, 1996		PTHREAD_GETSPECIFIC(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=pthread_getspecific&sektion=3&manpath=FreeBSD+14.3-RELEASE+and+Ports>

home | help