|
|
cc [options] -Kthread file#include <pthread.h>
int pthread_key_create(pthread_key_t *key, void (*destructor) (void *));
pthread_key_create sets the initial value of the key in all active and subsequently created threads to NULL. The caller must ensure that creation and use of this key are synchronized (see Intro(3pthread)).
Normally, the value bound to a key by a thread will be a pointer to dynamically allocated storage. When a thread terminates, per-thread context is automatically destroyed and, if a binding exists, the reference to the key is released. If the key has a destructor (see destructor parameter), the destructor is called with the bound value.
There is no fixed limit on the number of keys per process.
The key parameter is a pointer to a
pthread_key_t
, in which pthread_key_create
will store the newly created key.
The destructor parameter can be NULL or a pointer to an optional destructor function to be associated with key. When a thread terminates, if it has a non-NULL destructor function and a non-NULL value associated with key, the destructor function will be called with the bound value as an argument. If the value associated with key is NULL, the destructor is not called. Destructors are intended to free any dynamically allocated storage associated with the bound value.
If destructor functions call pthread_setspecific or pthread_getspecific, it might not be possible to destroy all bindings for a terminating thread.
The order of destructor calls is unspecified if more than one destructor exists for a thread when it exits.
If, after all the destructors have been called for all non-NULL values with associated destructors, there are still some non-NULL values with associated destructors, then the process will be repeated until no more than PTHREAD_DESTRUCTOR_ITERATIONS iterations of destructor calls have occurred.