Qt QThread必须要了解的几个函数

Posted 2021-03-15 ybqjymy

概述

    如果想对Qt中的QThread有个更加深刻的了解，必须要知道这几个重要的函数，现在就一一介绍下。

函数介绍

属性	返回值	函数体	功能
static	QThread *	QThread::currentThread()	返回当前线程的指针，静态函数。
static	Qt::HANDLE	QThread::currentThreadId()	返回当前线程的句柄，静态函数
static	bool	QThread::isFinished() const	如果线程执行结束，返回true，否则返回false
static	bool	QThread::isRunning() const	如果当前线程在运行中，返回true，否则返回false
static	int	QThread::idealThreadCount()	返回理理想状态下该系统支持的线程的数量。如果无发现检测到处理器的核数，返回值为-1
protected	int	exec()	使线程进入事件循环状态，并且处于wait状态，直到调用exit()函数使其退出。退出时返回值是调用exit()函数时的输入参数。如果调用quit()函数，其退出的返回值为0.该函数一般在run()函数中调用，使线程进入事件循环处理状态。
protected	void	exit(int returnCode = 0)	告知线程从事件循环状态退出，并且返回returnCode的值。一般说来，返回0表示成功退出，返回非0值表示遇到错误。调用该函数后，线程不会再进行事件处理，除非再次调用exec()函数。如果当前线程不处于执行状态，那么下次调用exec()也会直接返回
private signal	void	finished()	在线程执行完毕前发出该信号，当发出该信号时，意味着线程早已经退出了事件循环处理状态，即不再处理除了延迟删除事件(deferred deletion)之外的任何事件。可以把该信号和QObject::deleteLater()连接起来用来删除线程中的对象。如果强制使用terminate()函数来结束线程，那么将无法得知finish()信号的发送线程。另外，这是一个私有信号，所以用户无法发出这个信号。
static	bool	QThread::isInterruptionRequested() const	返回当前线程上运行的任务是否可以停止，可以通过requestInterruption()来进行中断查询。该函数可以使得长时间运行的任务彻底停止，永远不要检查该函数的返回值是否是安全的。但是进行长时间任务时提倡有规律的使用该方法。但是不要频繁使用该方法避免线程切换的开销。
static	bool	QThread::isRunning() const	返回当前线程是否正在运行，如果在运行，返回true，否则返回false
static	int	QThread::loopLevel() const	该函数返回当前事件循环的层级，但是该函数只能在线程内部调用。
static	void	QThread::msleep(unsigned long msecs)	强制线程休息msecs毫秒
static	void	QThread::usleep(unsigned long usecs)	强制线程休息usecs微秒
static	void	QThread::sleep(unsigned long secs)	强制线程休息secs秒
virtual protected	void	QThread::run()	该函数是线程运行的起始点。调用start()函数之后，新创建的函数调用该函数，默认的QThread简单的调用exec()进入事件循环机制。我们可以重载这个函数来实现更高级的线程管理方式。从该函数返回将结束线程。
static	void	QThread::setPriority(Priority priority)	该函数设置线程运行的优先级，如果线程并没有处于运行状态，该函数什么也不做。可以通过调用start()来指定一个优先级来启动线程。优先级的效果依赖于操作系统的调度方式，尤其是在不支持优先级的操作系统上，优先级设置会被忽略。
slot	void	QThread::quit()	告诉线程的事件循环退出并且返回0值，相当于调用QThread::exit(0)。如果线程没有事件循环，这个函数则什么也不做。
virtual protected	void	QThread::setStackSize(uint stackSize)	设置线程堆栈的最大值，如果设置的值大于0，那么就会将堆栈最大值设置为当前数值。否则，线程堆栈的最大值由操作系统来决定。警告：大部分操作系统都会自己设置线程堆栈的最大最小值，如果设置的堆栈大小超出范围，线程则不能启动。
static protected	void	QThread::setTerminationEnabled(bool enabled = true)
slot	void	QThread::start(Priority priority = InheritPriority)	通过调用run()函数启动线程。操作系统会根据优先级来调度线程。如果线程已经处于运行状态，该函数什么也不做。优先级设置依赖于操作系统的线程调度方式。
signal	void	QThread::started()	线程开始执行时发出该信号，发出时间在run()函数调用之前。注意：这是一个私有信号，因此只能由线程发出，用户不能发出该信号。
slot	void	QThread::terminate()	终止当前线程。线程或许不会立即被终止，依赖于线程的调度策略。一般情况下，调用该函数之后再调用QThread::wait()来确保线程结束。该线程终止后，等待该线程的其他线程将被唤醒。警告：该函数比较危险，不推荐这样做。线程可能在任何代码处终止。或许在修改数据时被终止，线程结束后自己不能去做清理工作。
static	bool	QThread::wait(unsigned long time = ULONG_MAX)	阻塞当前的进程，直到满足如下两个条件之一： 1.相关的线程完成其任务，然后如果线程已经结束，则该函数返回true，如果线程没有启动，则该函数也会返回true。 2. 经过了特定长度的时间，如果时间是ULONG_MAX（默认值），那么wait()函数几乎不会超时。（即该函数必须从run()函数返回）如果wait函数超时，那么该函数会返回false。
static	void	QThread::yieldCurrentThread()	将当前线程的执行权让给别的可执行线程。至于让给哪一个可执行线程，那就是操作系统的事情了。

 

 

使用技巧：
一般调用quit()函数之后可以紧接着调用wait()函数确保线程退出。
sleep()等让线程休眠的函数不需要调用，因为Qt中线程是事件驱动机制。但是如果是继承的QTHread类，在run()函数中使用了无限循环的方式，可以考虑msleep()函数来使线程休息一段时间，一般为1毫秒。