tail head cat sleep
QR code linking to this page

Manual Pages  — PTHREAD_GETSPECIFIC

NAME

pthread_getspecific – get a thread-specific data value

CONTENTS

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 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. 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 IEEE Std 1003.1-96 ("POSIX.1").

PTHREAD_GETSPECIFIC (3) April 4, 1996

tail head cat sleep
QR code linking to this page


Please direct any comments about this manual page service to Ben Bullock. Privacy policy.

Computer science would have progressed much further and faster if all of the time and effort that has been spent maintaining and nurturing Unix had been spent on a sounder operating system.
— The Unix Haters' handbook