tss_set()

Updated: April 19, 2023

Set a thread-specific data value

Synopsis:

#include <threads.h>

int tss_set( tss_t key,
             void* value );

Arguments:

key
The key associated with the data that you want to set. See tss_create().
value
The value that you want to store.

Library:

libc

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

Description:

The tss_set() function binds the thread-specific data value value with the thread-specific data key key.

You can call this function from within a thread-specific data destructor function.

Note: You must call this function with a key that you got from tss_create(). You can't use a key after destroying it with tss_delete().

Returns:

thrd_success
Success.
thrd_error
An error occurred.

Classification:

C11

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

Caveats:

Calling tss_set() with a non-NULL value may result in lost storage or infinite loops unless value was returned by tss_create().