1<HTML 2><HEAD 3><TITLE 4>SDL_SemValue</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_SemPost" 17HREF="sdlsempost.html"><LINK 18REL="NEXT" 19TITLE="SDL_CreateCond" 20HREF="sdlcreatecond.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="sdlsempost.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="sdlcreatecond.html" 63ACCESSKEY="N" 64>Next</A 65></TD 66></TR 67></TABLE 68><HR 69ALIGN="LEFT" 70WIDTH="100%"></DIV 71><H1 72><A 73NAME="SDLSEMVALUE" 74></A 75>SDL_SemValue</H1 76><DIV 77CLASS="REFNAMEDIV" 78><A 79NAME="AEN8218" 80></A 81><H2 82>Name</H2 83>SDL_SemValue -- Return the current value of a semaphore.</DIV 84><DIV 85CLASS="REFSYNOPSISDIV" 86><A 87NAME="AEN8221" 88></A 89><H2 90>Synopsis</H2 91><DIV 92CLASS="FUNCSYNOPSIS" 93><A 94NAME="AEN8222" 95></A 96><P 97></P 98><PRE 99CLASS="FUNCSYNOPSISINFO" 100>#include "SDL.h" 101#include "SDL/SDL_thread.h"</PRE 102><P 103><CODE 104><CODE 105CLASS="FUNCDEF" 106>Uint32 <B 107CLASS="FSFUNC" 108>SDL_SemValue</B 109></CODE 110>(SDL_sem *sem);</CODE 111></P 112><P 113></P 114></DIV 115></DIV 116><DIV 117CLASS="REFSECT1" 118><A 119NAME="AEN8228" 120></A 121><H2 122>Description</H2 123><P 124><TT 125CLASS="FUNCTION" 126>SDL_SemValue()</TT 127> returns the current semaphore value from 128the semaphore pointed to by <TT 129CLASS="PARAMETER" 130><I 131>sem</I 132></TT 133>.</P 134></DIV 135><DIV 136CLASS="REFSECT1" 137><A 138NAME="AEN8233" 139></A 140><H2 141>Return Value</H2 142><P 143>Returns current value of the semaphore.</P 144></DIV 145><DIV 146CLASS="REFSECT1" 147><A 148NAME="AEN8236" 149></A 150><H2 151>Examples</H2 152><P 153><PRE 154CLASS="PROGRAMLISTING" 155> sem_value = SDL_SemValue(my_sem);</PRE 156></P 157></DIV 158><DIV 159CLASS="REFSECT1" 160><A 161NAME="AEN8240" 162></A 163><H2 164>See Also</H2 165><P 166><A 167HREF="sdlcreatesemaphore.html" 168><TT 169CLASS="FUNCTION" 170>SDL_CreateSemaphore</TT 171></A 172>, 173<A 174HREF="sdldestroysemaphore.html" 175><TT 176CLASS="FUNCTION" 177>SDL_DestroySemaphore</TT 178></A 179>, 180<A 181HREF="sdlsemwait.html" 182><TT 183CLASS="FUNCTION" 184>SDL_SemWait</TT 185></A 186>, 187<A 188HREF="sdlsemtrywait.html" 189><TT 190CLASS="FUNCTION" 191>SDL_SemTryWait</TT 192></A 193>, 194<A 195HREF="sdlsemwaittimeout.html" 196><TT 197CLASS="FUNCTION" 198>SDL_SemWaitTimeout</TT 199></A 200>, 201<A 202HREF="sdlsempost.html" 203><TT 204CLASS="FUNCTION" 205>SDL_SemPost</TT 206></A 207></P 208></DIV 209><DIV 210CLASS="NAVFOOTER" 211><HR 212ALIGN="LEFT" 213WIDTH="100%"><TABLE 214SUMMARY="Footer navigation table" 215WIDTH="100%" 216BORDER="0" 217CELLPADDING="0" 218CELLSPACING="0" 219><TR 220><TD 221WIDTH="33%" 222ALIGN="left" 223VALIGN="top" 224><A 225HREF="sdlsempost.html" 226ACCESSKEY="P" 227>Prev</A 228></TD 229><TD 230WIDTH="34%" 231ALIGN="center" 232VALIGN="top" 233><A 234HREF="index.html" 235ACCESSKEY="H" 236>Home</A 237></TD 238><TD 239WIDTH="33%" 240ALIGN="right" 241VALIGN="top" 242><A 243HREF="sdlcreatecond.html" 244ACCESSKEY="N" 245>Next</A 246></TD 247></TR 248><TR 249><TD 250WIDTH="33%" 251ALIGN="left" 252VALIGN="top" 253>SDL_SemPost</TD 254><TD 255WIDTH="34%" 256ALIGN="center" 257VALIGN="top" 258><A 259HREF="thread.html" 260ACCESSKEY="U" 261>Up</A 262></TD 263><TD 264WIDTH="33%" 265ALIGN="right" 266VALIGN="top" 267>SDL_CreateCond</TD 268></TR 269></TABLE 270></DIV 271></BODY 272></HTML 273>