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:
| Safety: | |
|---|---|
| Cancellation point | No |
| Interrupt handler | No |
| Signal handler | Yes |
| Thread | Yes |