Penguin

SDL_!CreateSemaphore?

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

SEE ALSO

SDL_!DestroySemaphore?, SDL_!SemWait?, SDL_!SemTryWait?, SDL_!SemWaitTimeout?, SDL_!SemPost?, SDL_!SemValue?


This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.