Annotated edit history of
SDL_CreateSemaphore(3) version 2, including all changes.
View license author blame.
Rev |
Author |
# |
Line |
2 |
perry |
1 |
SDL_!CreateSemaphore |
|
|
2 |
!!!SDL_!CreateSemaphore |
1 |
perry |
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
RETURN VALUE |
|
|
7 |
EXAMPLES |
|
|
8 |
SEE ALSO |
|
|
9 |
---- |
|
|
10 |
!!NAME |
|
|
11 |
|
|
|
12 |
|
2 |
perry |
13 |
SDL_!CreateSemaphore- Creates a new semaphore and assigns an initial value to it. |
1 |
perry |
14 |
!!SYNOPSIS |
|
|
15 |
|
|
|
16 |
|
|
|
17 |
__#include |
|
|
18 |
__ |
|
|
19 |
|
|
|
20 |
|
2 |
perry |
21 |
__SDL_sem *SDL_!CreateSemaphore__(__Uint32 |
1 |
perry |
22 |
initial_value__); |
|
|
23 |
!!DESCRIPTION |
|
|
24 |
|
|
|
25 |
|
2 |
perry |
26 |
__SDL_!CreateSemaphore()__ creates a new semaphore and |
1 |
perry |
27 |
initializes it with the value __initial_value__. Each |
2 |
perry |
28 |
locking operation on the semaphore by ''SDL_!SemWait'', |
|
|
29 |
''SDL_!SemTryWait'' or ''SDL_!SemWaitTimeout'' will |
1 |
perry |
30 |
atomically decrement the semaphore value. The locking |
|
|
31 |
operation will be blocked if the semaphore value is not |
|
|
32 |
positive (greater than zero). Each unlock operation by |
2 |
perry |
33 |
''SDL_!SemPost'' will atomically increment the semaphore |
1 |
perry |
34 |
value. |
|
|
35 |
!!RETURN VALUE |
|
|
36 |
|
|
|
37 |
|
|
|
38 |
Returns a pointer to an initialized semaphore or __NULL__ |
|
|
39 |
if there was an error. |
|
|
40 |
!!EXAMPLES |
|
|
41 |
|
|
|
42 |
|
|
|
43 |
SDL_sem *my_sem; |
2 |
perry |
44 |
my_sem = SDL_!CreateSemaphore(INITIAL_SEM_VALUE); |
1 |
perry |
45 |
if (my_sem == NULL) { |
|
|
46 |
return CREATE_SEM_FAILED; |
|
|
47 |
} |
|
|
48 |
!!SEE ALSO |
|
|
49 |
|
|
|
50 |
|
2 |
perry |
51 |
__SDL_!DestroySemaphore__, __SDL_!SemWait__, |
|
|
52 |
__SDL_!SemTryWait__, __SDL_!SemWaitTimeout__, |
|
|
53 |
__SDL_!SemPost__, __SDL_!SemValue__ |
1 |
perry |
54 |
---- |
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.