SDL_WaitSemaphore

Wait until a semaphore has a positive value and then decrements it.

Header File

Defined in <SDL3/SDL_mutex.h>

Syntax

void SDL_WaitSemaphore(SDL_Semaphore *sem);

Function Parameters

Remarks

This function suspends the calling thread until the semaphore pointed to by sem has a positive value, and then atomically decrement the semaphore value.

This function is the equivalent of calling SDL_WaitSemaphoreTimeout() with a time length of -1.

Version

This function is available since SDL 3.2.0.

See Also

• SDL_SignalSemaphore
• SDL_TryWaitSemaphore
• SDL_WaitSemaphoreTimeout

CategoryAPI, CategoryAPIFunction, CategoryMutex