Restart all threads that are waiting on the condition variable.
Defined in <SDL3/SDL_mutex.h>
| cond | the condition variable to signal |
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
This function is available since SDL 3.0.0.
// BEWARE: This code example was migrated from the SDL2 Wiki, by only updating the names.
SDL_bool condition = SDL_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);
while (!condition) {
SDL_WaitCondition(cond, lock);
}
SDL_UnlockMutex(lock);
Thread_C:
SDL_LockMutex(lock);
/* ... */
condition = SDL_TRUE;
/* ... */
SDL_BroadcastCondition(cond);
SDL_UnlockMutex(lock);
SDL_DestroyCondition(cond);
SDL_DestroyMutex(lock);