1/****************************************************************************
2**
3** Copyright (C) 2014 Digia Plc and/or its subsidiary(-ies).
4** Contact: http://www.qt-project.org/legal
5**
6** This file is part of the QtCore module of the Qt Toolkit.
7**
8** $QT_BEGIN_LICENSE:LGPL$
9** Commercial License Usage
10** Licensees holding valid commercial Qt licenses may use this file in
11** accordance with the commercial license agreement provided with the
12** Software or, alternatively, in accordance with the terms contained in
13** a written agreement between you and Digia. For licensing terms and
14** conditions see http://qt.digia.com/licensing. For further information
15** use the contact form at http://qt.digia.com/contact-us.
16**
17** GNU Lesser General Public License Usage
18** Alternatively, this file may be used under the terms of the GNU Lesser
19** General Public License version 2.1 as published by the Free Software
20** Foundation and appearing in the file LICENSE.LGPL included in the
21** packaging of this file. Please review the following information to
22** ensure the GNU Lesser General Public License version 2.1 requirements
23** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24**
25** In addition, as a special exception, Digia gives you certain additional
26** rights. These rights are described in the Digia Qt LGPL Exception
27** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28**
29** GNU General Public License Usage
30** Alternatively, this file may be used under the terms of the GNU
31** General Public License version 3.0 as published by the Free Software
32** Foundation and appearing in the file LICENSE.GPL included in the
33** packaging of this file. Please review the following information to
34** ensure the GNU General Public License version 3.0 requirements will be
35** met: http://www.gnu.org/copyleft/gpl.html.
36**
37**
38** $QT_END_LICENSE$
39**
40****************************************************************************/
41
42#ifndef QTHREAD_H
43#define QTHREAD_H
44
45#include <QtCore/qobject.h>
46
47#include <limits.h>
48
49QT_BEGIN_HEADER
50
51QT_BEGIN_NAMESPACE
52
53QT_MODULE(Core)
54
55class QThreadData;
56class QThreadPrivate;
57
58#ifndef QT_NO_THREAD
59class Q_CORE_EXPORT QThread : public QObject
60{
61public:
62 static Qt::HANDLE currentThreadId();
63 static QThread *currentThread();
64 static int idealThreadCount();
65 static void yieldCurrentThread();
66
67 explicit QThread(QObject *parent = 0);
68 ~QThread();
69
70 enum Priority {
71 IdlePriority,
72
73 LowestPriority,
74 LowPriority,
75 NormalPriority,
76 HighPriority,
77 HighestPriority,
78
79 TimeCriticalPriority,
80
81 InheritPriority
82 };
83
84 void setPriority(Priority priority);
85 Priority priority() const;
86
87 bool isFinished() const;
88 bool isRunning() const;
89
90 void setStackSize(uint stackSize);
91 uint stackSize() const;
92
93 void exit(int retcode = 0);
94
95public Q_SLOTS:
96 void start(Priority = InheritPriority);
97 void terminate();
98 void quit();
99
100public:
101 // default argument causes thread to block indefinately
102 bool wait(unsigned long time = ULONG_MAX);
103
104Q_SIGNALS:
105 void started();
106 void finished();
107 void terminated();
108
109protected:
110 virtual void run();
111 int exec();
112
113 static void setTerminationEnabled(bool enabled = true);
114
115 static void sleep(unsigned long);
116 static void msleep(unsigned long);
117 static void usleep(unsigned long);
118
119#ifdef QT3_SUPPORT
120public:
121 inline QT3_SUPPORT bool finished() const { return isFinished(); }
122 inline QT3_SUPPORT bool running() const { return isRunning(); }
123#endif
124
125protected:
126 QThread(QThreadPrivate &dd, QObject *parent = 0);
127
128private:
129 Q_OBJECT
130 Q_DECLARE_PRIVATE(QThread)
131
132 static void initialize();
133 static void cleanup();
134
135 friend class QCoreApplication;
136 friend class QThreadData;
137};
138
139#else // QT_NO_THREAD
140
141class Q_CORE_EXPORT QThread : public QObject
142{
143public:
144 static Qt::HANDLE currentThreadId() { return Qt::HANDLE(currentThread()); }
145 static QThread* currentThread();
146
147protected:
148 QThread(QThreadPrivate &dd, QObject *parent = 0);
149
150private:
151 explicit QThread(QObject *parent = 0);
152 static QThread *instance;
153
154 friend class QCoreApplication;
155 friend class QThreadData;
156 friend class QAdoptedThread;
157 Q_DECLARE_PRIVATE(QThread)
158};
159
160#endif // QT_NO_THREAD
161
162QT_END_NAMESPACE
163
164QT_END_HEADER
165
166#endif // QTHREAD_H
167