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

概述

如果想对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毫秒。

原文地址:https://www.cnblogs.com/ybqjymy/p/12210967.html

时间: 2024-11-13 10:01:55

Qt QThread必须要了解的几个函数的相关文章

QT点击"X"按钮,调用closeEvent()函数来实现调用特定事件

背景: QT在用户关闭窗口(直接点击"X"键)时,程序一般都需要做一些善后的事情,就我现在的程序来说,既关闭USB.如何实现? 正文: 首先,在对应窗体的".h"文件包含 #include <QCloseEvent>;的头文件. 其次,在该".h"文件中声明函数 void closeEvent( QCloseEvent * event); 注意:该函数已经在QT内部建立为点击"X"按钮的槽,不能更改其函数名: 最后

QT中关闭应用程序和窗口的函数(quit(),exit()以及close()的区别)

使用QT编辑界面,其中带来很大方便的一点就是Qt中自带丰富的.种类齐全的类及其功能函数,程序员可以在编辑程序的过程中简单地直接调用.关于窗口关闭的操作,在这里指出常用的三个槽,即quit(),exit()以及close().    首先说明窗口退出时,系统提示对话框的代码编辑.对主程序的退出,可以调用成员函数exit(),同时也可以调用槽quit(),二者此时都能起到关闭应用程序的作用.只是应注意二者调用的方式不同.如下程序示例:        {         QApplication* a

Qt - QThread(翻译帮助文档)

QThread Class 详细描述 QThread 类提供一个平台无关的方法来管理线程. 一个QThread对象管理一个程序中的控制线程.QThread在run()中开始执行任务.默认地,run()通过调用exec()开始事件循环,并且在线程中运行Qt事件循环. 你可通过使用QObject::moveToThread()将worker对象移到线程中来使用worker对象. class Worker : public QObject { Q_OBJECT public slots: void d

qt QThread

QThread类提供了一个平台无关的方式来管理线程. 一个QThread对象在程序控制中管理一个线程.线程在run()中开始执行.默认情况下,run()通过调用exec()启动事件循环并在线程里运行一个Qt的事件循环. 可以使用worker-object通过QObject::moveToThread将它们移动到线程.class Worker : public QObject { Q_OBJECT public slots: void doWork(const QString &parameter

qt线程动态回调被调类中的函数

1.需求 要求封装一个qt线程能在不同类中调用,并能回调被调用类中的函数 2.解决 尝试多种方法,最终决定采用动态加载lamda表达式的方法解决 3.代码 catthread.h #ifndef CATTHREAD_H #define CATTHREAD_H #include <QtCore/QThread> #include <functional> class catthread : public QThread { Q_OBJECT public: catthread(QOb

Qt设置系统时间(使用SetSystemTime API函数)

大家都知道Qt中有QDateTime等有关时间与日期的类,类中包含很多成员函数,可以很方便的实现有关时间与日期的操作,比如:想要获得系统当前的时间与日期,可以调用currentDateTime(); 但是Qt并没有提供设置系统时间的方法,这样我们只能自己来区分平台,调用平台相关的API,这篇文章实现在Windows下的设置. 常用的与时间有关的Win32 API有两个:GetSystemTime();  与  SetSystemTime();  下面是函数原型: VOID GetSystemTi

一个基于QT的解析interproscan结果的C++成员函数

结构域预测软件interproscan提供多种输出格式,出于后期分析的需要,选用了gff3格式.我比较喜欢结合数据库进行分析,所以先要把数据导入数据库. 我之前用QT写好了界面,所以只要在菜单里添加一个QAction.再在主窗口类中添加槽函数就可以了.这里给出我解析文件的槽函数. void MainWindow::on_interproToMyDB(){ PfamToMyDBDlg * dbDlg = new PfamToMyDBDlg(this); dbDlg->exec(); QFile q

Qt中gb2312/GBK的URL编解码函数

编码函数: QByteArray encodeURI(QString str) { QByteArray array; QTextCodec *codec=QTextCodec::codecForName("GBK"); QByteArray tmpArray; tmpArray = codec->fromUnicode(str); for(int i=0,size = tmpArray.length();i<size;i++){ char ch = tmpArray.at

[Qt学习篇]Qthread实现多线程操作

一.QThread类概述 QThread类为用户管理多线程提供了一种平台无关的途径. #include <QThread> 继承自QObject类 二.QThread类详述 QThread对象在程序内部进行控制线程的管理,QThread起始于run()函数额执行.默认情况下,run()通过调用exec()启动事件循环(event loop),并在线程内部执行Qt 的事件循环. 以下示例通过QObject::moveToThread()调用把worker对象添加到线程中运行: class Wor