]>
Commit | Line | Data |
---|---|---|
6e6110ee VZ |
1 | \section{\class{wxCriticalSectionLocker}}\label{wxcriticalsectionlocker} |
2 | ||
3 | This is a small helper class to be used with \helpref{wxCriticalSection}{wxcriticalsection} | |
4 | objects. A wxCriticalSectionLocker enters the critical section in the | |
5 | constructor and leaves it in the destructor making it much more difficult to | |
6 | forget to leave a critical section (which, in general, will lead to serious | |
7 | and difficult to debug problems). | |
8 | ||
5b1eea6a VZ |
9 | Example of using it: |
10 | ||
11 | \begin{verbatim} | |
12 | void SetFoo() | |
13 | { | |
14 | // gs_critSect is some (global) critical section guarding access to the | |
15 | // object "foo" | |
16 | wxCriticalSectionLocker locker(gs_critSect); | |
17 | ||
18 | if ( ... ) | |
19 | { | |
20 | // do something | |
21 | ... | |
22 | ||
23 | return; | |
24 | } | |
25 | ||
26 | // do something else | |
27 | ... | |
28 | ||
29 | return; | |
30 | } | |
31 | \end{verbatim} | |
32 | ||
33 | Without wxCriticalSectionLocker, you would need to remember to manually leave | |
34 | the critical section before each {\tt return}. | |
35 | ||
6e6110ee VZ |
36 | \wxheading{Derived from} |
37 | ||
38 | None. | |
39 | ||
954b8ae6 JS |
40 | \wxheading{Include files} |
41 | ||
42 | <wx/thread.h> | |
43 | ||
6e6110ee VZ |
44 | \wxheading{See also} |
45 | ||
b82827dd | 46 | \helpref{wxCriticalSection}{wxcriticalsection}, |
6e6110ee VZ |
47 | \helpref{wxMutexLocker}{wxmutexlocker} |
48 | ||
49 | \latexignore{\rtfignore{\wxheading{Members}}} | |
50 | ||
51 | \membersection{wxCriticalSectionLocker::wxCriticalSectionLocker}\label{wxcriticalsectionlockerctor} | |
b82827dd | 52 | |
5b1eea6a | 53 | \func{}{wxCriticalSectionLocker}{\param{wxCriticalSection\& }{criticalsection}} |
6e6110ee VZ |
54 | |
55 | Constructs a wxCriticalSectionLocker object associated with given | |
5b1eea6a | 56 | {\it criticalsection} and enters it. |
6e6110ee VZ |
57 | |
58 | \membersection{wxCriticalSectionLocker::\destruct{wxCriticalSectionLocker}}\label{wxcriticalsectionlockerdtor} | |
b82827dd | 59 | |
6e6110ee VZ |
60 | \func{}{\destruct{wxCriticalSectionLocker}}{\void} |
61 | ||
5b1eea6a | 62 | Destuctor leaves the critical section. |
b82827dd | 63 |