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

SDL_CreateCondition

Create a condition variable.

Header File

Syntax

SDL_Condition * SDL_CreateCondition(void);

Return Value

(SDL_Condition *) Returns a new condition variable or NULL on failure; call SDL_GetError() for more information.

Version

This function is available since SDL 3.1.3.

Code Examples

Typical use of condition variables:

// BEWARE: This code example was migrated from the SDL2 Wiki, by only updating the names.

bool condition = false;
SDL_Mutex *lock;
SDL_Condition *cond;
lock = SDL_CreateMutex();
cond = SDL_CreateCondition();


Thread_A:
    SDL_LockMutex(lock);
    while (!condition) {
        SDL_WaitCondition(cond, lock);
    }
    SDL_UnlockMutex(lock);
Thread_B:
    SDL_LockMutex(lock);
    /* ... */
    condition = true;
    /* ... */
    SDL_SignalCondition(cond);
    SDL_UnlockMutex(lock);

SDL_DestroyCondition(cond);
SDL_DestroyMutex(lock);