Qt 之 QtConcurrent

  本文以 Qt 中的 QtConcurrent::run() 函数为例，介绍如何将函数运行在单独的线程中。

1  QtConcurrent::run()

  QtConcurrent 是命名空间 (namespace)，它提供了高层次的函数接口 (APIs)，使所写程序，可根据计算机的 CPU 核数，自动调整运行的线程数目。

  下面是 Qt 例程 runfunction，对应目录为  D:\Qt\Qt5.12.3\Examples\Qt-5.12.3\qtconcurrent\runfucntion

1.1  .pro 工程文件

  使用 QtConcurrent 模块，需要在 .pro 中添加： QT += concurrent

QT += concurrent widgets
CONFIG += console

SOURCES += main.cpp

1.2  main.cpp

 1 #include 
 2 #include 
 3 #include 
 4 #include 
 5 
 6 #include "qtconcurrentrun.h"
 7 
 8 using namespace QtConcurrent;
 9 
10 void func(QString name)
11 {
12     qDebug() << name << "from" << QThread::currentThread();
13 }
14 
15 int main(int argc, char **argv)
16 {
17     QApplication app(argc, argv);
18 
19     QFuture<void> fut1 = run(func, QString("Thread 1"));
20     QFuture<void> fut2 = run(func, QString("Thread 2"));
21 
22     fut1.waitForFinished();
23     fut2.waitForFinished();
24 }

  用 QtConcurrent::run() 函数，分别将  func() 运行在两个不同的线程中，输出结果如下：

 

"Thread 1" from QThread(0x1b74fd2ebc0, name = "Thread (pooled)")
"Thread 2" from QThread(0x1b74fd534e0, name = "Thread (pooled)")

 

  下面是 QtConcurrent::run() 的详细使用，阅读完 2 和 3，再看上面的 runfunction 例程，就容易理解了。

 2  普通函数

2.1  将函数运行在某一个线程中

extern void func();
QFuture<void> future = QtConcurrent::run(func);

  如果要为其指定线程池，可以将线程池的指针作为第一个参数传递进去

extern void func();
QThreadPool pool;
QFuture<void> future = QtConcurrent::run(&pool, func);

2.2  向该函数传递参数

  需要传递的参数，则跟在函数名之后，依次加入

extern void FuncWithArguments(int arg1, const QString &string);

 int integer = ...;
 QString string = ...;

 QFuture<void> future = QtConcurrent::run(FuncWithArguments,integer,string);

2.3  获取该函数的计算结果

extern QString Func(const QByteArray &input);

QByteArray byte_array = ...;

QFuture future = QtConcurrent::run(func, byte_array);
...
QString result = future.result();

 

3  成员函数

  将类中的成员函数运行在某一个线程中，可将指向该类实例的 引用或指针 作为 QtConcurrent::run 的第一个参数传递进去，

  常量成员函数一般传递 常量引用 (const reference)，而非常量成员函数一般传递 指针 (pointer)

3.1  常量成员函数

   在一个单独的线程中，调用 QByteArray 的常量成员函数 split()，传递给 run() 函数的参数是 bytearray

  QByteArray bytearray = "hello world";
  QFuture > future = QtConcurrent::run(bytearray, &QByteArray::split, ',');
  ...
  QList result = future.result();

3.2  非常量成员函数

   在一个单独的线程中，调用 QImage 的非常量成员函数 invertPixels()，传递给 run() 函数的参数是 &image

  QImage image = ...;
  QFuture<void> future = QtConcurrent::run(&image, &QImage::invertPixels, QImage::InvertRgba);
  ...
  future.waitForFinished();
  // At this point, the pixels in 'image' have been inverted

 

参考资料：

  Qt Assistant | Qt 5.12 | Qt Concurrent | Concurrent Run