1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
|
//
// Copyright (c) ZeroC, Inc. All rights reserved.
//
#ifndef ICE_UTIL_THREAD_H
#define ICE_UTIL_THREAD_H
#include <IceUtil/Config.h>
#include <IceUtil/Shared.h>
#include <IceUtil/Handle.h>
#include <IceUtil/Mutex.h>
namespace IceUtil
{
class Time;
class ICE_API ThreadControl
{
public:
//
// Constructs a ThreadControl representing the current thread.
// join and detach cannot be called on such ThreadControl object.
//
ThreadControl();
#if defined(_WIN32)
ThreadControl(HANDLE, DWORD);
#else
explicit ThreadControl(pthread_t);
#endif
//
// Default copy destructor, assignment operator and destructor OK
//
//
// == and != are meaningful only before the thread is joined/detached,
// or while the thread is still running.
//
bool operator==(const ThreadControl&) const;
bool operator!=(const ThreadControl&) const;
//
// Wait until the controlled thread terminates. The call has POSIX
// semantics.
//
// At most one thread can wait for the termination of a given
// thread. Calling join on a thread on which another thread is
// already waiting for termination results in undefined behaviour,
// as does joining with a thread after having joined with it
// previously, or joining with a detached thread.
//
void join();
//
// Detach a thread. Once a thread is detached, it cannot be
// detached again, nor can it be joined with. Every thread that
// was created using the IceUtil::Thread class must either be
// joined with or detached exactly once. Detaching a thread a
// second time, or detaching a thread that was previously joined
// with results in undefined behavior.
//
void detach();
//
// id() returns the Thread ID on Windows and the underlying pthread_t
// on POSIX platforms.
//
#if defined(_WIN32)
typedef DWORD ID;
#else
typedef pthread_t ID;
#endif
ID id() const;
static void sleep(const Time&);
static void yield();
private:
#if defined(_WIN32)
HANDLE _handle;
DWORD _id;
#else
pthread_t _thread;
//
// Used to prevent joining/detaching a ThreadControl constructed
// with the default constructor. Only needed to enforce our
// portable join/detach behavior.
//
bool _detachable;
#endif
};
class ICE_API Thread : public virtual IceUtil::Shared
{
public:
Thread();
Thread(const std::string&);
virtual ~Thread();
virtual void run() = 0;
ThreadControl start(size_t = 0);
ThreadControl start(size_t, int priority);
ThreadControl getThreadControl() const;
bool operator==(const Thread&) const;
bool operator<(const Thread&) const;
//
// Check whether a thread is still alive.
//
bool isAlive() const;
//
// This function is an implementation detail;
// do not call it.
//
void _done();
//
// Get the thread name
//
const std::string& name() const;
protected:
const std::string _name;
Mutex _stateMutex;
bool _started;
bool _running;
#if defined(_WIN32)
HANDLE _handle;
DWORD _id;
#else
pthread_t _thread;
#endif
private:
#ifdef _WIN32
#else
ThreadControl start(size_t, bool, int);
#endif
Thread(const Thread&); // Copying is forbidden
void operator=(const Thread&); // Assignment is forbidden
};
typedef Handle<Thread> ThreadPtr;
}
#endif
|
