You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
313 lines
5.4 KiB
313 lines
5.4 KiB
<HTML |
|
><HEAD |
|
><TITLE |
|
>Multi-threaded Programming</TITLE |
|
><META |
|
NAME="GENERATOR" |
|
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+ |
|
"><LINK |
|
REL="HOME" |
|
TITLE="SDL Library Documentation" |
|
HREF="index.html"><LINK |
|
REL="UP" |
|
TITLE="SDL Reference" |
|
HREF="reference.html"><LINK |
|
REL="PREVIOUS" |
|
TITLE="SDL_CDtrack" |
|
HREF="sdlcdtrack.html"><LINK |
|
REL="NEXT" |
|
TITLE="SDL_CreateThread" |
|
HREF="sdlcreatethread.html"><META |
|
NAME="KEYWORD" |
|
CONTENT="threads"><META |
|
NAME="KEYWORD" |
|
CONTENT="function"></HEAD |
|
><BODY |
|
CLASS="CHAPTER" |
|
BGCOLOR="#FFF8DC" |
|
TEXT="#000000" |
|
LINK="#0000ee" |
|
VLINK="#551a8b" |
|
ALINK="#ff0000" |
|
><DIV |
|
CLASS="NAVHEADER" |
|
><TABLE |
|
SUMMARY="Header navigation table" |
|
WIDTH="100%" |
|
BORDER="0" |
|
CELLPADDING="0" |
|
CELLSPACING="0" |
|
><TR |
|
><TH |
|
COLSPAN="3" |
|
ALIGN="center" |
|
>SDL Library Documentation</TH |
|
></TR |
|
><TR |
|
><TD |
|
WIDTH="10%" |
|
ALIGN="left" |
|
VALIGN="bottom" |
|
><A |
|
HREF="sdlcdtrack.html" |
|
ACCESSKEY="P" |
|
>Prev</A |
|
></TD |
|
><TD |
|
WIDTH="80%" |
|
ALIGN="center" |
|
VALIGN="bottom" |
|
></TD |
|
><TD |
|
WIDTH="10%" |
|
ALIGN="right" |
|
VALIGN="bottom" |
|
><A |
|
HREF="sdlcreatethread.html" |
|
ACCESSKEY="N" |
|
>Next</A |
|
></TD |
|
></TR |
|
></TABLE |
|
><HR |
|
ALIGN="LEFT" |
|
WIDTH="100%"></DIV |
|
><DIV |
|
CLASS="CHAPTER" |
|
><H1 |
|
><A |
|
NAME="THREAD" |
|
></A |
|
>Chapter 12. Multi-threaded Programming</H1 |
|
><DIV |
|
CLASS="TOC" |
|
><DL |
|
><DT |
|
><B |
|
>Table of Contents</B |
|
></DT |
|
><DT |
|
><A |
|
HREF="sdlcreatethread.html" |
|
>SDL_CreateThread</A |
|
> -- Creates a new thread of execution that shares its parent's properties.</DT |
|
><DT |
|
><A |
|
HREF="sdlthreadid.html" |
|
>SDL_ThreadID</A |
|
> -- Get the 32-bit thread identifier for the current thread.</DT |
|
><DT |
|
><A |
|
HREF="sdlgetthreadid.html" |
|
>SDL_GetThreadID</A |
|
> -- Get the SDL thread ID of a SDL_Thread</DT |
|
><DT |
|
><A |
|
HREF="sdlwaitthread.html" |
|
>SDL_WaitThread</A |
|
> -- Wait for a thread to finish.</DT |
|
><DT |
|
><A |
|
HREF="sdlkillthread.html" |
|
>SDL_KillThread</A |
|
> -- Gracelessly terminates the thread.</DT |
|
><DT |
|
><A |
|
HREF="sdlcreatemutex.html" |
|
>SDL_CreateMutex</A |
|
> -- Create a mutex</DT |
|
><DT |
|
><A |
|
HREF="sdldestroymutex.html" |
|
>SDL_DestroyMutex</A |
|
> -- Destroy a mutex</DT |
|
><DT |
|
><A |
|
HREF="sdlmutexp.html" |
|
>SDL_mutexP</A |
|
> -- Lock a mutex</DT |
|
><DT |
|
><A |
|
HREF="sdlmutexv.html" |
|
>SDL_mutexV</A |
|
> -- Unlock a mutex</DT |
|
><DT |
|
><A |
|
HREF="sdlcreatesemaphore.html" |
|
>SDL_CreateSemaphore</A |
|
> -- Creates a new semaphore and assigns an initial value to it.</DT |
|
><DT |
|
><A |
|
HREF="sdldestroysemaphore.html" |
|
>SDL_DestroySemaphore</A |
|
> -- Destroys a semaphore that was created by <A |
|
HREF="sdlcreatesemaphore.html" |
|
>SDL_CreateSemaphore</A |
|
>.</DT |
|
><DT |
|
><A |
|
HREF="sdlsemwait.html" |
|
>SDL_SemWait</A |
|
> -- Lock a semaphore and suspend the thread if the semaphore value is zero.</DT |
|
><DT |
|
><A |
|
HREF="sdlsemtrywait.html" |
|
>SDL_SemTryWait</A |
|
> -- Attempt to lock a semaphore but don't suspend the thread.</DT |
|
><DT |
|
><A |
|
HREF="sdlsemwaittimeout.html" |
|
>SDL_SemWaitTimeout</A |
|
> -- Lock a semaphore, but only wait up to a specified maximum time.</DT |
|
><DT |
|
><A |
|
HREF="sdlsempost.html" |
|
>SDL_SemPost</A |
|
> -- Unlock a semaphore.</DT |
|
><DT |
|
><A |
|
HREF="sdlsemvalue.html" |
|
>SDL_SemValue</A |
|
> -- Return the current value of a semaphore.</DT |
|
><DT |
|
><A |
|
HREF="sdlcreatecond.html" |
|
>SDL_CreateCond</A |
|
> -- Create a condition variable</DT |
|
><DT |
|
><A |
|
HREF="sdldestroycond.html" |
|
>SDL_DestroyCond</A |
|
> -- Destroy a condition variable</DT |
|
><DT |
|
><A |
|
HREF="sdlcondsignal.html" |
|
>SDL_CondSignal</A |
|
> -- Restart a thread wait on a condition variable</DT |
|
><DT |
|
><A |
|
HREF="sdlcondbroadcast.html" |
|
>SDL_CondBroadcast</A |
|
> -- Restart all threads waiting on a condition variable</DT |
|
><DT |
|
><A |
|
HREF="sdlcondwait.html" |
|
>SDL_CondWait</A |
|
> -- Wait on a condition variable</DT |
|
><DT |
|
><A |
|
HREF="sdlcondwaittimeout.html" |
|
>SDL_CondWaitTimeout</A |
|
> -- Wait on a condition variable, with timeout</DT |
|
></DL |
|
></DIV |
|
><P |
|
>SDL provides functions for creating threads, mutexes, semphores and condition variables.</P |
|
><P |
|
>In general, you must be very aware of concurrency and data integrity issues |
|
when writing multi-threaded programs. Some good guidelines include: |
|
<P |
|
></P |
|
><UL |
|
><LI |
|
><P |
|
>Don't call SDL video/event functions from separate threads</P |
|
></LI |
|
><LI |
|
><P |
|
>Don't use any library functions in separate threads</P |
|
></LI |
|
><LI |
|
><P |
|
>Don't perform any memory management in separate threads</P |
|
></LI |
|
><LI |
|
><P |
|
>Lock global variables which may be accessed by multiple threads</P |
|
></LI |
|
><LI |
|
><P |
|
>Never terminate threads, always set a flag and wait for them to quit</P |
|
></LI |
|
><LI |
|
><P |
|
>Think very carefully about all possible ways your code may interact</P |
|
></LI |
|
></UL |
|
></P |
|
><DIV |
|
CLASS="NOTE" |
|
><BLOCKQUOTE |
|
CLASS="NOTE" |
|
><P |
|
><B |
|
>Note: </B |
|
>SDL's threading is not implemented on MacOS, due to that lack of preemptive thread support (Mac OS X dos nt suffer from this problem)</P |
|
></BLOCKQUOTE |
|
></DIV |
|
></DIV |
|
><DIV |
|
CLASS="NAVFOOTER" |
|
><HR |
|
ALIGN="LEFT" |
|
WIDTH="100%"><TABLE |
|
SUMMARY="Footer navigation table" |
|
WIDTH="100%" |
|
BORDER="0" |
|
CELLPADDING="0" |
|
CELLSPACING="0" |
|
><TR |
|
><TD |
|
WIDTH="33%" |
|
ALIGN="left" |
|
VALIGN="top" |
|
><A |
|
HREF="sdlcdtrack.html" |
|
ACCESSKEY="P" |
|
>Prev</A |
|
></TD |
|
><TD |
|
WIDTH="34%" |
|
ALIGN="center" |
|
VALIGN="top" |
|
><A |
|
HREF="index.html" |
|
ACCESSKEY="H" |
|
>Home</A |
|
></TD |
|
><TD |
|
WIDTH="33%" |
|
ALIGN="right" |
|
VALIGN="top" |
|
><A |
|
HREF="sdlcreatethread.html" |
|
ACCESSKEY="N" |
|
>Next</A |
|
></TD |
|
></TR |
|
><TR |
|
><TD |
|
WIDTH="33%" |
|
ALIGN="left" |
|
VALIGN="top" |
|
>SDL_CDtrack</TD |
|
><TD |
|
WIDTH="34%" |
|
ALIGN="center" |
|
VALIGN="top" |
|
><A |
|
HREF="reference.html" |
|
ACCESSKEY="U" |
|
>Up</A |
|
></TD |
|
><TD |
|
WIDTH="33%" |
|
ALIGN="right" |
|
VALIGN="top" |
|
>SDL_CreateThread</TD |
|
></TR |
|
></TABLE |
|
></DIV |
|
></BODY |
|
></HTML |
|
> |