(This is the documentation for SDL3, which is the current stable version. SDL2 was the previous version!)

SDL_IsMainThread

Return whether this is the main thread.

Header File

Syntax

bool SDL_IsMainThread(void);

Return Value

(bool) Returns true if this thread is the main thread, or false otherwise.

Remarks

On Apple platforms, the main thread is the thread that runs your program's main() entry point. On other platforms, the main thread is the one that calls SDL_Init(SDL_INIT_VIDEO), which should usually be the one that runs your program's main() entry point. If you are using the main callbacks, SDL_AppInit(), SDL_AppIterate(), and SDL_AppQuit() are all called on the main thread.

Thread Safety

It is safe to call this function from any thread.

Version

This function is available since SDL 3.2.0.