SDL_TryWaitSemaphore - Man Page

See if a semaphore has a positive value and decrement it if it does.

Header File

Defined in SDL3/SDL_mutex.h

Synopsis

#include "SDL3/SDL.h"

bool SDL_TryWaitSemaphore(SDL_Semaphore *sem);

Description

This function checks to see if the semaphore pointed to by sem has a positive value and atomically decrements the semaphore value if it does. If the semaphore doesn't have a positive value, the function immediately returns false.

Function Parameters

sem

the semaphore to wait on.

Return Value

Returns true if the wait succeeds, false if the wait would block.

Availability

This function is available since SDL 3.2.0.

See Also

·(3), SDL_SignalSemaphore(3), ·(3), SDL_WaitSemaphore(3), ·(3), SDL_WaitSemaphoreTimeout(3)

Referenced By

SDL_CreateSemaphore(3), SDL_SignalSemaphore(3), SDL_WaitSemaphore(3), SDL_WaitSemaphoreTimeout(3).

SDL 3.2.2 Simple Directmedia Layer SDL3 FUNCTIONS