NAME¶

SDL_SetTLS - Set the current thread's value associated with a thread local storage ID.

SYNOPSIS¶

#include <SDL3/SDL_thread.h>

bool SDL_SetTLS(SDL_TLSID *id, const void *value, SDL_TLSDestructorCallback destructor);

DESCRIPTION¶

If the thread local storage ID is not initialized (the value is 0), a new ID will be created in a thread-safe way, so all calls using a pointer to the same ID will refer to the same local storage.

Note that replacing a value from a previous call to this function on the same thread does _not_ call the previous value's destructor!

destructor can be NULL; it is assumed that value does not need to be cleaned up if so.

FUNCTION PARAMETERS¶

id

a pointer to the thread local storage ID, may not be NULL.

value

the value to associate with the ID for the current thread.

destructor

a function called when the thread exits, to free the value, may be NULL.

RETURN VALUE¶

Returns true on success or false on failure; call SDL_GetError() for more information.

THREAD SAFETY¶

It is safe to call this function from any thread.

AVAILABILITY¶

This function is available since SDL 3.2.0.

SEE ALSO¶

SDL_GetTLS(3)