[QT] QThread 类详解
该类提供平台独立的线程。
#include <QThread>
继承QObject
公共类型
enum
Priority { IdlePriority, LowestPriority, LowPriority, NormalPriority,
..., InheritPriority }
公共函数
QThread ( QObject * parent = 0 )
~QThread ()void exit ( int returnCode = 0 )bool isFinished () constbool
isRunning
() constPriority priority () constvoid setPriority ( Priority priority
)void setStackSize ( uint
stackSize )uint stackSize () constbool wait
( unsigned long time = ULONG_MAX )
公共槽
void quit ()void start (
Priority priority = InheritPriority )void terminate ()信号
void
finished ()void started ()void terminated ()静态公共成员
QThread *
currentThread ()Qt::HANDLE currentThreadId ()int idealThreadCount ()void
yieldCurrentThread ()
受保护的函数
int exec ()virtual void run
()静态受保护的成员
void msleep ( unsigned long msecs )void
setTerminationEnabled ( bool enabled = true )
void sleep ( unsigned
long secs )void usleep ( unsigned long usecs )详细描述
一个QThread代表一个独立的线程
控制在程序中。它分享数据和所有其他的线程,但是独立运行在一个多任务的操作系统中。代替开始
在main中,QThread开始在run。默认
的,run开始时间循环,通过调用exec。为了创建你自己的线程,建QThread的子类,并继承run。
例如:
class
MyThread : public QThread
{
public:
void run();
};
void MyThread::run()
{
QTcpSocket socket;
//
connect QTcpSocket's signals somewhere meaningful
...
socket.connectToHost(hostName, portNumber);
exec();
}
这将创
建一个QTcpSocket在这个线程中,运行线程的时间循环。使用start方法来开始运行。当你返回从run,运行结束,就像一个应
用那样当
你离开main。QThread将注意你发出一个信号,当线程started,finished,terminated,或者你能用isFinished
和isRunning
来查询线程的状态,使用wait来阻塞,直到线程已经完成运行。
每个线程得到他自己的堆栈从操作系统中。操作系统也
决定堆栈的默认大小。你能使用setStackSize来设置一个惯例的堆栈大小。
每个QThread能有他自己的事件循环。你能开始事件循环通
过调用exec。你能停止它通过调用exit或quit。拥有一个事件循环使信号和
槽的链接成为可能。使用一个机制叫做队列链接。它也使使用那些
要求事件循环的类成为可能,例如QTimer和QTcpSocket。注意,尽
管如此,那是不可能的使用任何widget的类。
在极端情
况下,你可能想强制terminate一个线程。尽管如此,那样做是危险地和应该被阻止的。请读文件为terminate和
setTerminationEnabled。
静
态函数currentThreadId和currentThread返回目前运行的线程的标示符。
QThread也提供平台独立的sleep函
数。使用sleep,msleep,usleep。
成员类型文件
enum QThread::Priority
enum类型代表
操作系统怎样安排新产生的线程。
内容 值 描述
QThread::IdlePriority 0
安排只是当没有其他线程在运行
QThread::LowestPriority 1 安排少于低优先级
QThread::LowPriority 2
安排少于正常优先级
QThread::NormalPriority 3 默认的操作系统优先级
QThread::HighPriority 4
安排高于正常优先级
QThread::HighestPriority 5 安排高于高优先级
QThread::TimeCriticalPriority
6 尽可能的安排
QThread::InheritPriority 7 使用同样的优先级,这是默认的
成员函数文件
QThread::QThread(QObject*
parent=0)
构造一个新的线程用被给的parent。这个线程不开始运行直到start被调用
QThread::~QThread
()
摧毁线程
注意删除一个线程对象将不停止运行线程。删除一个运行的QThread将可能导致一个程序冲突。你能wait来确保它完
成。
QThread * QThread::currentThread () [static]
返回一个代表目前运行的线程的指
针。
Qt::HANDLE QThread::currentThreadId () [static]
返回线程句柄。
警
告:该函数返回的句柄是被使用为了内部目的,不应该被用于任何应用的代码。
在windows,返回值是一个假句柄。它不能被使用为数值比较。这个
函数返回DWORD返回被win32函数getCurrentThreadId,不是被
getCurrentThread返回的handle。
int
QThread::exec () [protected]
进入事件循环,等直到exit被调用。如果通过quit调用exit,返回值将
是0。那是必须的调用这个函数来开始事件循环。
void QThread::exit ( int returnCode = 0 )
告
诉线程的事件循环来退出
在调用这个函数后,线程离开事件循环,返回从QEventLoop::exec()。并且返回返回码。
根据协定,
返回0代表成功,非0代表失败
注意不像c函数,这个函数返回caller—it is event processing thar
stops.
如果没有一个事件循环,这个函数不做任何事情。
void QThread::finished () [signal]
这
个信号被发出当线程结束运行。
int QThread::idealThreadCount () [static]
返回能被运行在
系统上的理想的线程数。
bool QThread::isFinished () const
返回true如果线程是完成的。
bool
QThread::isRunning () const
void QThread::msleep ( unsigned long
msecs ) [static protected]
Priority QThread::priority () const
返
回一个线程的优先级,如果函数不运行,返回inheritPriority
void QThread::quit () [slot]
等
同于exit(0).
void QThread::run () [virtual protected]
线程的开始点。在调用
start后,新的线程调用这个函数,默认的继承调用exec。
你能重载这个函数来做其他有用的工作。
void
QThread::setPriority ( Priority priority )
设置优先级
void
QThread::setStackSize ( uint stackSize )
设置最大的堆栈大小为线程。
警告:大部分操作系统预
设最大和最小限制在线程堆栈大小上。这个线程将失败开始,如果堆栈是不在这个限制范围内
void
QThread::setTerminationEnabled ( bool enabled = true ) [static
protected]
设置terminate()函数的有效性。
void QThread::sleep ( unsigned
long secs ) [static protected]
uint QThread::stackSize () const
void
QThread::start ( Priority priority = InheritPriority ) [slot]
开始运行
程序通过调用run。
void QThread::started () [signal]
当线程开始,发出该信号。
void
QThread::terminate () [slot]
终止运行的线程。这个线程可能马上终止,也可能延时终止。在terminate
后使用wait 同步终止。
警告:这个函数是危险地,不被鼓励使用。
void QThread::terminated ()
[signal]
void QThread::usleep ( unsigned long usecs ) [static
protected]
bool QThread::wait ( unsigned long time = ULONG_MAX )
阻
塞线程直到这些情况被遇到
线程结束运行。
Time已经过去。(超时)
void
QThread::yieldCurrentThread () [static]
让开线程给另一个可运行的线程。注意这由操作系统决定
Qt线程中有一个公共的抽象类,所有的线程都是从这个QThread抽象类中派生的,要实现QThread中的纯虚函数run(),run()函数是通过
start()函数来实现调用的。例如:
1 class MyThread : public QThread {
2 public:
3 virtual void run();
4 };
5
6 void MyThread::run()
7 {
8 for( int count =
0; count < 20; count++ ) {
9 sleep( 1 );
10
qDebug( "Ping!" );
11 }
12 }
13
14 int
main()
15 {
16 MyThread a;
17 MyThread b;
18
19 a.start();//自动调用run(),否则即使该线程创建,也是一开始就挂起
20
b.start();
21 //要等待线程a,b都退出
22 a.wait();
23
b.wait();
24 }
25