pthread_key_delete()

Updated: April 19, 2023

Delete a thread-specific data key

Synopsis:

#include <pthread.h>

int pthread_key_delete( pthread_key_t key );

Arguments:

key
The key, which you created by calling pthread_key_create(), that you want to delete.

Library:

libc

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

Description:

The pthread_key_delete() function deletes the thread-specific data key key that you previously created with pthread_key_create(). The destructor function bound to key isn't called by this function, and won't be called at thread termination. You can call this function from a thread specific data destructor function.

If you need to release any data bound to the key in any threads, do so before deleting the key.

Returns:

EOK
Success.
EINVAL
Invalid thread-specific data key key.

Classification:

POSIX 1003.1

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