SDL_SetTLS3
Set the current thread's value associated with a thread local storage id.
Usage
#include "SDL3/SDL.h"
bool SDL_SetTLS(SDL_TLSID *id, const void *value, SDL_TLSDestructorCallback destructor);
Header file
Defined in SDL3/SDL_thread.h
Overview
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.