Qt 线程 QThread类详解

Qt 线程中QThread的使用

在进行桌面应用程序开发的时候, 假设应用程序在某些情况下需要处理比较复杂的逻辑, 如果只有一个线程去处理,就会导致窗口卡顿,无法处理用户的相关操作。这种情况下就需要使用多线程,其中一个线程处理窗口事件,其他线程进行逻辑运算,多个线程各司其职,不仅可以提高用户体验还可以提升程序的执行效率

在 qt 中使用了多线程,有些事项是需要额外注意的:

  • 默认的线程在Qt中称之为窗口线程,也叫主线程,负责窗口事件处理或者窗口控件数据的更新
  • 子线程负责后台的业务逻辑处理,子线程中不能对窗口对象做任何操作,这些事情需要交给窗口线程处理
  • 主线程和子线程之间如果要进行数据的传递,需要使用Qt中的信号槽机制

1. 线程类 QThread

Qt 中提供了一个线程类,通过这个类就可以创建子线程了,Qt 中一共提供了两种创建子线程的方式,后边会依次介绍其使用方式。先来看一下这个类中提供的一些常用 API 函数:

// Qt中的线程可以设置优先级
// 得到当前线程的优先级
Priority QThread::priority() const;
void QThread::setPriority(Priority priority);
优先级:
    QThread::IdlePriority         --> 最低的优先级
    QThread::LowestPriority
    QThread::LowPriority
    QThread::NormalPriority
    QThread::HighPriority
    QThread::HighestPriority
    QThread::TimeCriticalPriority --> 最高的优先级
    QThread::InheritPriority      --> 子线程和其父线程的优先级相同, 默认是这个


start(): 启动线程,使线程进入运行状态,调用线程的run()方法。
run(): 线程的执行函数,需要在该函数中编写线程所需执行的任务。
quit(): 终止线程的事件循环,在下一个事件处理周期结束时退出线程。
wait(): 阻塞当前线程,直到线程执行完成或超时。
finished(): 在线程执行完成时发出信号。
terminate(): 强制终止线程的执行,不推荐使用,可能导致资源泄漏和未定义行为。
isRunning(): 判断线程是否正在运行。
currentThreadId(): 返回当前线程的ID。
yieldCurrentThread(): 释放当前线程的时间片,允许其他线程执行。
msleep(): 让当前线程休眠指定的毫秒数。


2 信号槽

// 和调用 exit() 效果是一样的
// 调用这个函数之后, 再调用 wait() 函数
[slot] void QThread::quit();
// 启动子线程
[slot] void QThread::start(Priority priority = InheritPriority);
// 线程退出, 可能是会马上终止线程, 一般情况下不使用这个函数
[slot] void QThread::terminate();

// 线程中执行的任务完成了, 发出该信号
// 任务函数中的处理逻辑执行完毕了
[signal] void QThread::finished();
// 开始工作之前发出这个信号, 一般不使用
[signal] void QThread::started();

静态函数

// 返回一个指向管理当前执行线程的QThread的指针
[static] QThread *QThread::currentThread();
// 返回可以在系统上运行的理想线程数 == 和当前电脑的 CPU 核心数相同
[static] int QThread::idealThreadCount();
// 线程休眠函数
[static] void QThread::msleep(unsigned long msecs);	// 单位: 毫秒
[static] void QThread::sleep(unsigned long secs);	// 单位: 秒
[static] void QThread::usleep(unsigned long usecs);	// 单位: 微秒

4 重写函数

// 子线程要处理什么任务, 需要写到 run() 中
[virtual protected] void QThread::run();

2种线程使用方式

使用 QThread 时的一个常见误区。

  1. QThread 实例存在于实例化它的旧线程中:

    • 当您创建一个 QThread 对象时,该对象会存在于创建它的线程中,而不是在新创建的线程中。
    • 这意味着,您调用 QThread 对象的方法和槽时,实际上是在创建该对象的线程中执行的,而不是在新创建的工作线程中。
  2. 在新线程中调用槽:

    • 如果您希望在新创建的工作线程中执行某些操作,比如调用槽函数,就不能直接将这些槽函数定义在 QThread 子类中。
    • 因为 QThread 子类的方法和槽都会在创建该对象的线程中执行,而不是在工作线程中执行。
  3. 使用工作对象方法:

    • 为了在新创建的工作线程中执行操作,您需要定义一个独立的工作对象类,并将所有的工作逻辑封装在该类中。
    • 在工作线程中,您可以创建这个工作对象的实例,并在该实例上调用方法来执行工作。

使用 QThread 时需要注意区分线程的概念。QThread 对象本身存在于创建它的线程中,而不是在新创建的工作线程中。如果您希望在工作线程中执行操作,需要使用独立的工作对象,而不是直接在 QThread 子类中实现。这样可以确保在正确的线程中执行您的工作逻辑。 

简化:在这里先记住

1.new QThread 是在当前代码位置创建出来的

2.线程调用槽函数是有坑点的。

3.最好使用工作对象方法

线程和工作逻辑

  • 主线程和子线程执行的顺序不确定,偶尔主线程在前,偶尔子线程在前。
  • 只有run()函数运行在子线程中,run调用子函数则在子线程调用子函数。
class WorkerThread : public QThread
{
    Q_OBJECT

public:
    void run() override  //子线程工作函数
    {
        // 在新线程中执行耗时任务
        for (int i = 0; i < 5; ++i)
        {
            qDebug() << "Worker thread doing work..." << i;
            sleep(1);
        }
        emit finished();
    }

signals:
    void finished();
};

int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 创建并启动工作线程
    WorkerThread* workerThread = new WorkerThread;
    QObject::connect(workerThread, &WorkerThread::finished, workerThread, &WorkerThread::deleteLater);
    workerThread->start();



     // 等待任务完成
    workerThread->wait();

    // 停止并退出事件循环
    a.exit();
    return a.exec();
}

这个例子演示了如何在一个全新的线程中执行耗时的工作任务。通过继承 QThread 并重写 run() 方法,我们可以在新线程中运行自定义的工作逻辑。这种方式与下列的例子有所不同,下列的例子是在工作对象中执行任务,而不是在 QThread 子类中。

线程和工作对象

  • 槽函数无论是线程的信号触发还是自定义信号触发,槽函数都在新线程里运行。
  • 成员函数和主函数运行在主线程当中。
#include <QDebug>
#include <QThread>

class Worker : public QObject
{
    Q_OBJECT

public:
    Worker()
    {
    }

public slots:
    void doWork()
    {
        // 执行耗时的计算任务
        for (int i = 0; i < 5; ++i)
        {
            qDebug() << "Worker thread doing work..." << i;
            QThread::sleep(1);
        }

        // 计算完成后,发射 finished 信号
        emit finished();
    }

signals:
    void finished();
};


int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);

    // 创建工作线程
    QThread* workerThread = new QThread;

    // 创建工作对象实例,并将其移动到工作线程中
    Worker* worker = new Worker;
    worker->moveToThread(workerThread);//将其移动到工作线程中。这确保了 Worker 对象的所有操作都在工作线程中进行

    // 连接信号和槽
    QObject::connect(workerThread, &QThread::started, worker, &Worker::doWork);
    QObject::connect(worker, &Worker::finished, workerThread, &QThread::quit);
    //即使 main() 函数执行完毕,主线程退出,QThread 对象也不会立即被释放,而是会等待工作线程完成后再被删除。
    QObject::connect(worker, &Worker::finished, worker, &Worker::deleteLater);
    QObject::connect(workerThread, &QThread::finished, workerThread, &QThread::deleteLater);

    // 启动工作线程
    workerThread->start();

    return a.exec();
}

在这个例子中,QThread 对象代表了实际的工作线程,而 Worker 对象包含了实际的工作逻辑。这样,我们就可以在工作线程中执行耗时的计算任务,而不会阻塞主线程。当任务完成时,Worker 对象会发射 finished 信号,从而触发工作线程退出和对象清理。 

代码运行示例

重写线程类:work.h

#ifndef WORK_H
#define WORK_H

#include<QDebug>
#include<QThread>
#include<QMutex>
#include<QSemaphore>
class work : public QThread
{
    Q_OBJECT

public:
    work();
    virtual ~work(); // 添加虚拟析构函数


public:
    void run() override;

    void stopAndWait() {  //完美退出
        m_running = false;
        wait();     //等待任务完成
        exit();  //停止并退出事件循环
        qDebug() << "stopAndWait";

        deleteLater(); //安全地删除 QObject 及其子类对象 异步地删除对象,而不是立即删除 注意:该函数是线程安全,多次调用该函数是安全的;
    }

private:
    bool m_running; //完美退出
    static uint16_t index;
};

#endif // WORK_H


#include "work.h"

uint16_t work::index = 1;

work::work()
{
    // 构造函数实现
    m_running=true;
}

work::~work()
{
    // 虚拟析构函数实现
}
void work::run() {
    // 执行耗时工作
    while (m_running) {
        qDebug() << "Worker thread doing run..." << this->index++;
        sleep(1);
    }
    qDebug() << "Worker thread exiting.";
}

工作对象类

workthread.h

#ifndef WORKTHREAD2_H
#define WORKTHREAD2_H
#include<QDebug>
#include<QThread>


class workthread2 : public QObject
{
    Q_OBJECT
public:
    workthread2()=default;
    ~workthread2()=default;
public:
    enum class ThreadState { Idle, Running, Finished };
    Q_ENUM(ThreadState)

signals:
    void finished();

public slots:
    void doWork()
    {
        // 执行耗时的计算任务
        for (int i = 0; i < 5; ++i)
        {
            qDebug() << "Worker thread doing work..." << i;
            QThread::sleep(1);
        }

        // 计算完成后,发射 finished 信号
        emit finished();
    }


};

#endif // WORKTHREAD2_H

main函数

#include <QCoreApplication>

#include"work.h"
#include<workthread2.h>
#include<QTimer>
void qtThread_text(){
    //第一种 继承重写run方法
    QVector<work*> workerThreads;
    // 创建并启动工作线程
    for(int i=0;i<3;i++)
    {
        workerThreads.append(new work());
    }
    for(int i=0;i<3;i++)
    {
        workerThreads.at(i)->start();
    }


    // 等待一段时间后,通知线程退出
    QThread::sleep(1);
    for(work* data :workerThreads){
        data->stopAndWait();
        //data->deleteLater();
    }
    //    for(int i=0;i<3;i++)
    //    {
    //        workerthread[i]->wait();
    //        workerthread[i]->terminate(); //发送线程终止信号
    //    }


    //第2种 使用对象模式 注意此模式是在当前线程运行
    QThread* newthread= new QThread;
    QThread* newthread2= new QThread;
    // 启动工作线程 一个对象只能隶属于一个线程


    workthread2* work2 = new workthread2;
    workthread2* work2_2 = new workthread2;
    work2->moveToThread(newthread);
    work2_2->moveToThread(newthread2);
    // 启动工作线程
   newthread->start();
   newthread2->start();

   // 连接信号和槽
    QObject::connect(newthread, &QThread::started, work2, &workthread2::doWork);
    QObject::connect(work2, &workthread2::finished, newthread, &QThread::quit);
    QObject::connect(work2, &workthread2::finished, work2, &workthread2::deleteLater);
    QObject::connect(newthread, &QThread::finished, newthread, &QThread::deleteLater);

    QObject::connect(newthread2, &QThread::started, work2_2, &workthread2::doWork);
    QObject::connect(work2_2, &workthread2::finished, newthread2, &QThread::quit);
    QObject::connect(work2_2, &workthread2::finished, work2_2, &workthread2::deleteLater);
    QObject::connect(newthread2, &QThread::finished, newthread2, &QThread::deleteLater);

    newthread->start();
    newthread2->start();
/*
    newthread->wait();
    newthread->exit();
    当 newthread->wait() 被调用时,它会阻塞当前线程(即主线程)直到 newthread 线程退出。然后 newthread->exit() 被调用,停止并退出了事件循环。
    qDebug() << "a.exec()"; 这行代码就不会被执行。
*/

    // 等待线程完成并退出事件循环
   newthread->wait();
   newthread2->wait();

   newthread->exit();
   newthread2->exit();
}
int main(int argc, char *argv[])
{
    QCoreApplication a(argc, argv);
    qtThread_text();

    // 手动调用 a.exec()
    qDebug() << "a.exec()";
    return a.exec(); //开启Qt 的事件循环
}

运行结果

总结

上述提到的两种使用 QThread 的方式有以下几点主要区别: (第一种重写 第二种movetoThread)

  1. 线程的创建方式

  2. ***线程与工作对象的关系:

    • 在第一种方式中,线程和工作逻辑是耦合在一起的,因为工作逻辑直接在 QThread 的子类中实现。
    • 在第二种方式中,线程和工作对象是解耦的,工作逻辑被封装在独立的 Worker 对象中。
  3. ***信号槽的执行位置:
    • move版本槽函数无论是线程的信号触发还是自定义信号触发,槽函数都在新线程里运行。
    • 重写版本信号槽是在主线程执行。
  4. 线程安全性:

    • 在第二种方式中,由于工作对象是在工作线程中运行的,因此不需要担心线程安全性问题。
    • 在第一种方式中,如果在 QThread 的子类中访问了共享资源,就需要特别注意线程安全性。
  5. 灵活性和可重用性:

    重写灵活性和可重用性低,move版本低耦合
  6. 错误处理:

    • 在第二种方式中,可以更容易地在工作对象中捕获和处理错误,因为工作逻辑被封装在了独立的对象中。
    • 在第一种方式中,错误处理可能更加困难,因为工作逻辑和线程紧耦合在一起。

总的来说,主要区别在于代码结构和设计模式,而不是线程的创建方式。无论采用哪种方式,都是在主线程中创建和启动了工作线程。由于4.8更新了movetothread版本,既然是更新,说明这种方法更好,建议大家在使用时采用movetothread版本

参考文献:

Qt 线程中QThread的使用_qt qthread-CSDN博客

QThread 类 | Qt 核心 5.15.17 --- QThread Class | Qt Core 5.15.17

一文搞定之Qt多线程(QThread、moveToThread)_qthread movetothread-CSDN博客

最后附上源代码链接
对您有帮助的话,帮忙点个star

36-qthread-qmutex-qsemaphore · jbjnb/Qt demo - 码云 - 开源中国 (gitee.com)

相关推荐

  1. Qt中使用线QThread

    2024-07-09 17:06:07       22 阅读
  2. Qt之多线编程(QThread)

    2024-07-09 17:06:07       8 阅读
  3. QT6之多线——子化QObject和子QThread

    2024-07-09 17:06:07       11 阅读
  4. QThread线退出

    2024-07-09 17:06:07       28 阅读

最近更新

  1. redis+spring面试题

    2024-07-09 17:06:07       0 阅读
  2. 线段树分治+可撤销并查集 学习笔记

    2024-07-09 17:06:07       0 阅读
  3. 含有罗马字母的txt转换为csv文件读取-报错

    2024-07-09 17:06:07       0 阅读
  4. go标准库---net/http服务端

    2024-07-09 17:06:07       0 阅读

热门阅读

  1. 牛客周赛 Round 50

    2024-07-09 17:06:07       12 阅读
  2. 量化机器人如何提高投资效率?

    2024-07-09 17:06:07       4 阅读
  3. Emacs相关

    2024-07-09 17:06:07       7 阅读
  4. 细水长流:SKlearn中模型的增量训练实践

    2024-07-09 17:06:07       8 阅读
  5. 论如何搭建属于自己的服务器?

    2024-07-09 17:06:07       6 阅读
  6. RabbitMQ实现延迟消息

    2024-07-09 17:06:07       11 阅读
  7. 【数据挖掘】银行信用卡风险大数据分析与挖掘

    2024-07-09 17:06:07       7 阅读
  8. emacs 重新加载磁盘上的文件

    2024-07-09 17:06:07       7 阅读
  9. Linux学习笔记(一)

    2024-07-09 17:06:07       8 阅读
  10. 用WPF实现的窗体是怎么运行的?

    2024-07-09 17:06:07       10 阅读
  11. Mac OS M3 安装 Docker 并解决芯片不支持问题

    2024-07-09 17:06:07       6 阅读