SDL_Create Semaphore(3) - Waikato Linux Users Group

Edit PageHistory Diff Info LikePages

Note: You are viewing an old revision of this page. View the current version.

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; }