WlugWiki - SDL_Create Semaphore(3)

LikePages

SDL_!CreateSemaphore

NAME SYNOPSIS DESCRIPTION RETURN VALUE EXAMPLES SEE ALSO

NAME

SDL_!CreateSemaphore- Creates a new semaphore and assigns an initial value to it.

SYNOPSIS

#include

SDL_sem *SDL_!CreateSemaphore(Uint32 initial_value);

DESCRIPTION

SDL_!CreateSemaphore() creates a new semaphore and initializes it with the value initial_value. Each locking operation on the semaphore by SDL_!SemWait, SDL_!SemTryWait or SDL_!SemWaitTimeout will atomically decrement the semaphore value. The locking operation will be blocked if the semaphore value is not positive (greater than zero). Each unlock operation by SDL_!SemPost will atomically increment the semaphore value.

RETURN VALUE

Returns a pointer to an initialized semaphore or NULL if there was an error.

EXAMPLES

SDL_sem *my_sem; my_sem = SDL_!CreateSemaphore(INITIAL_SEM_VALUE); if (my_sem == NULL) { return CREATE_SEM_FAILED; }