NAME

pthread_getspecific − Obtains the thread-specific data associated with the specified key. 

LIBRARY

DECthreads POSIX 1003.1c Library (libpthread.so)

SYNOPSIS

#include <pthread.h>

void   ∗pthread_getspecific(
                         pthread_key_t    key);

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

IEEE Std 1003.1c-1995, POSIX System Application Program Interface

PARAMETERS

keyThe context key identifies the thread-specific data to be obtained. 

DESCRIPTION

This routine obtains the thread-specific data associated with the specified key for the current thread.  Obtain this key by calling the pthread_key_create(3) routine.  This routine returns the value currently bound to the specified key on behalf of the calling thread. 

This routine may be called from a thread-specific data destructor function. 

RETURN VALUES

No errors are returned.  This routine returns the thread-specific data value associated with the specified key argument.  If no thread-specific data value is associated with key, or if key is not defined, then this routine returns a NULL value. 

RELATED INFORMATION

Functions: pthread_key_create(3), pthread_setspecific(3)

Manuals: Guide to DECthreads and Programmer’s Guide