SDL_CreateSemaphore(3) SDL API Reference SDL_CreateSemaphore(3)NAME
SDL_CreateSemaphore- Creates a new semaphore and assigns
an initial value to it.
SYNOPSIS
#include "SDL.h" #include "SDL_thread.h"
SDL_sem *SDL_CreateSemaphore(Uint32 initial_value);
DESCRIPTIONSDL_CreateSemaphore() creates a new semaphore and initial-
izes it with the value initial_value. Each locking opera-
tion 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;
}
SEE ALSO
SDL_DestroySemaphore, SDL_SemWait, SDL_SemTryWait,
SDL_SemWaitTimeout, SDL_SemPost, SDL_SemValue
SDL Tue 11 Sep 2001, 23:0SDL_CreateSemaphore(3)