sdlcreatemutex.html revision 9682c8870b8ff5e4ac2e4c70b759f791c6f38c1f 
1<HTML
2><HEAD
3><TITLE
4>SDL_CreateMutex</TITLE
5><META
6NAME="GENERATOR"
7CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
8"><LINK
9REL="HOME"
10TITLE="SDL Library Documentation"
11HREF="index.html"><LINK
12REL="UP"
13TITLE="Multi-threaded Programming"
14HREF="thread.html"><LINK
15REL="PREVIOUS"
16TITLE="SDL_KillThread"
17HREF="sdlkillthread.html"><LINK
18REL="NEXT"
19TITLE="SDL_DestroyMutex"
20HREF="sdldestroymutex.html"></HEAD
21><BODY
22CLASS="REFENTRY"
23BGCOLOR="#FFF8DC"
24TEXT="#000000"
25LINK="#0000ee"
26VLINK="#551a8b"
27ALINK="#ff0000"
28><DIV
29CLASS="NAVHEADER"
30><TABLE
31SUMMARY="Header navigation table"
32WIDTH="100%"
33BORDER="0"
34CELLPADDING="0"
35CELLSPACING="0"
36><TR
37><TH
38COLSPAN="3"
39ALIGN="center"
40>SDL Library Documentation</TH
41></TR
42><TR
43><TD
44WIDTH="10%"
45ALIGN="left"
46VALIGN="bottom"
47><A
48HREF="sdlkillthread.html"
49ACCESSKEY="P"
50>Prev</A
51></TD
52><TD
53WIDTH="80%"
54ALIGN="center"
55VALIGN="bottom"
56></TD
57><TD
58WIDTH="10%"
59ALIGN="right"
60VALIGN="bottom"
61><A
62HREF="sdldestroymutex.html"
63ACCESSKEY="N"
64>Next</A
65></TD
66></TR
67></TABLE
68><HR
69ALIGN="LEFT"
70WIDTH="100%"></DIV
71><H1
72><A
73NAME="SDLCREATEMUTEX"
74></A
75>SDL_CreateMutex</H1
76><DIV
77CLASS="REFNAMEDIV"
78><A
79NAME="AEN7820"
80></A
81><H2
82>Name</H2
83>SDL_CreateMutex&nbsp;--&nbsp;Create a mutex</DIV
84><DIV
85CLASS="REFSYNOPSISDIV"
86><A
87NAME="AEN7823"
88></A
89><H2
90>Synopsis</H2
91><DIV
92CLASS="FUNCSYNOPSIS"
93><A
94NAME="AEN7824"
95></A
96><P
97></P
98><PRE
99CLASS="FUNCSYNOPSISINFO"
100>#include "SDL.h"
101#include "SDL_thread.h"</PRE
102><P
103><CODE
104><CODE
105CLASS="FUNCDEF"
106>SDL_mutex *<B
107CLASS="FSFUNC"
108>SDL_CreateMutex</B
109></CODE
110>(void);</CODE
111></P
112><P
113></P
114></DIV
115></DIV
116><DIV
117CLASS="REFSECT1"
118><A
119NAME="AEN7830"
120></A
121><H2
122>Description</H2
123><P
124>Create a new, unlocked mutex.</P
125></DIV
126><DIV
127CLASS="REFSECT1"
128><A
129NAME="AEN7833"
130></A
131><H2
132>Examples</H2
133><PRE
134CLASS="PROGRAMLISTING"
135>SDL_mutex *mut;
136
137mut=SDL_CreateMutex();
138.
139.
140if(SDL_mutexP(mut)==-1){
141  fprintf(stderr, "Couldn't lock mutex\n");
142  exit(-1);
143}
144.
145/* Do stuff while mutex is locked */
146.
147.
148if(SDL_mutexV(mut)==-1){
149  fprintf(stderr, "Couldn't unlock mutex\n");
150  exit(-1);
151}
152
153SDL_DestroyMutex(mut);&#13;</PRE
154></DIV
155><DIV
156CLASS="REFSECT1"
157><A
158NAME="AEN7836"
159></A
160><H2
161>See Also</H2
162><P
163><A
164HREF="sdlmutexp.html"
165><TT
166CLASS="FUNCTION"
167>SDL_mutexP</TT
168></A
169>,
170<A
171HREF="sdlmutexv.html"
172><TT
173CLASS="FUNCTION"
174>SDL_mutexV</TT
175></A
176>,
177<A
178HREF="sdldestroymutex.html"
179><TT
180CLASS="FUNCTION"
181>SDL_DestroyMutex</TT
182></A
183></P
184></DIV
185><DIV
186CLASS="NAVFOOTER"
187><HR
188ALIGN="LEFT"
189WIDTH="100%"><TABLE
190SUMMARY="Footer navigation table"
191WIDTH="100%"
192BORDER="0"
193CELLPADDING="0"
194CELLSPACING="0"
195><TR
196><TD
197WIDTH="33%"
198ALIGN="left"
199VALIGN="top"
200><A
201HREF="sdlkillthread.html"
202ACCESSKEY="P"
203>Prev</A
204></TD
205><TD
206WIDTH="34%"
207ALIGN="center"
208VALIGN="top"
209><A
210HREF="index.html"
211ACCESSKEY="H"
212>Home</A
213></TD
214><TD
215WIDTH="33%"
216ALIGN="right"
217VALIGN="top"
218><A
219HREF="sdldestroymutex.html"
220ACCESSKEY="N"
221>Next</A
222></TD
223></TR
224><TR
225><TD
226WIDTH="33%"
227ALIGN="left"
228VALIGN="top"
229>SDL_KillThread</TD
230><TD
231WIDTH="34%"
232ALIGN="center"
233VALIGN="top"
234><A
235HREF="thread.html"
236ACCESSKEY="U"
237>Up</A
238></TD
239><TD
240WIDTH="33%"
241ALIGN="right"
242VALIGN="top"
243>SDL_DestroyMutex</TD
244></TR
245></TABLE
246></DIV
247></BODY
248></HTML
249>