pthread_getspecific()

Updated: April 19, 2023

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.

Note: 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

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