SDL_Create Semaphore(3) - Waikato Linux Users Group

Edit PageHistory Diff Info 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; }