---

pthread_getspecific()

Get a thread-specific data value

Synopsis:

#include <pthread.h>

void* pthread_getspecific( pthread_key_t key );

Arguments:

key

The key associated with the data that you want to get. See pthread_key_create().

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The pthread_getspecific() function returns the thread-specific data value currently bound to the thread-specific-data key key in the calling thread, or NULL if no value is bound or the key doesn't exist. You can call this function from a thread-specific-data destructor function.

---

You must call this function with a key that you got from pthread_key_create(). You can't use a key after destroying it with pthread_key_delete().

---

Returns:

The data value, or NULL.

Examples:

See pthread_key_create().

Classification:

POSIX 1003.1 THR

Safety:
Cancellation point	No
Interrupt handler	No
Signal handler	Yes
Thread	Yes

See also:

pthread_key_create(), pthread_key_delete(), pthread_setspecific().

---