Manual Pages for UNIX Operating System command usage for man SDL_CreateSemaphore

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

DESCRIPTION
     SDL_CreateSemaphore() creates a new semaphore  and  initial-
     izes 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  sema-
     phore value is not positive (greater than zero). Each unlock
     operation by SDL_SemPost will atomically increment the sema-
     phore 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            Last change: Tue 11 Sep 2001, 23:00              1