SDL Wiki
(This is the documentation for SDL3, which is under heavy development and the API is changing! SDL2 is the current stable version!)


THIS PAGE IS A WORK IN PROGRESS ... Please make edits to this page to improve it!


Create a piece of thread-local storage.


SDL_TLSID SDL_TLSCreate(void);

Return Value

Returns the newly created thread local storage identifier or 0 on error.


This creates an identifier that is globally visible to all threads but refers to data that is thread-specific.


This function is available since SDL 3.0.0.

Code Examples

static SDL_SpinLock tls_lock;
static SDL_TLSID thread_local_storage;

void SetMyThreadData(void *value)
    if (!thread_local_storage) {
        if (!thread_local_storage) {
            thread_local_storage = SDL_TLSCreate();
    SDL_TLSSet(thread_local_storage, value, 0);

void *GetMyThreadData(void)
    return SDL_TLSGet(thread_local_storage);

CategoryAPI, CategoryThread, CategoryDraft

[ edit | delete | history | feedback | raw ]

[ front page | index | search | recent changes | git repo | offline html ]

All wiki content is licensed under Creative Commons Attribution 4.0 International (CC BY 4.0).
Wiki powered by ghwikipp.