GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  SDL_CREATESEMAPHORE (3)

NAME

SDL_CreateSemaphore - Creates a new semaphore and assigns an initial value to it.

CONTENTS

SYNOPSIS

#include "SDL.h" #include "SDL_thread.h"

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

Search for    or go to Top of page |  Section 3 |  Main Index


SDL SDL_CREATESEMAPHORE (3) Tue 11 Sep 2001, 23:00

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.