NAME¶

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

SYNOPSIS¶

#include "SDL3/SDL.h"

int SDL_SemTryWait(SDL_sem *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 SDL_MUTEX_TIMEDOUT .

FUNCTION PARAMETERS¶

sem

the semaphore to wait on

RETURN VALUE¶

Returns 0 if the wait succeeds, SDL_MUTEX_TIMEDOUT if the wait would block, or a negative error code on failure; call

SDL_GetError () for more information.

AVAILABILITY¶

This function is available since SDL 3.0.0.

SEE ALSO¶

SDL_CreateSemaphore(3), SDL_DestroySemaphore(3), SDL_SemPost(3), SDL_SemValue(3), SDL_SemWait(3), SDL_SemWaitTimeout(3)