[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

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.


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 THR

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

See also:

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


[Previous] [Contents] [Index] [Next]