Scroll to navigation

SDL_SemWaitTimeout(3) SDL3 FUNCTIONS SDL_SemWaitTimeout(3)

NAME

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

SYNOPSIS

#include "SDL3/SDL.h"
int SDL_SemWaitTimeout(SDL_sem *sem, Sint32 timeoutMS);

DESCRIPTION

This function suspends the calling thread until either the semaphore pointed to by sem has a positive value, the call is interrupted by a signal or error, or the specified time has elapsed. If the call is successful it will atomically decrement the semaphore value.

FUNCTION PARAMETERS

the semaphore to wait on
the length of the timeout, in milliseconds

RETURN VALUE

Returns 0 if the wait succeeds, SDL_MUTEX_TIMEDOUT if the wait does not succeed in the allotted time, 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_SemTryWait(3), SDL_SemValue(3), SDL_SemWait(3)

SDL 3.0.0 SDL