Qt之Concurrent Run

简述

QtConcurrent::run() 函数在一个单独的线程中运行一个函数， 函数的返回值通过 QFuture API 提供。

该函数是 Qt之Concurrent框架 的一部分。

在单独的线程中运行函数

要在另一个线程中运行函数，使用 QtConcurrent::run()：

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

这将在从默认的 QThreadPool 获取的单独的线程中运行 aFunction 。可以使用 QFuture 和 QFutureWatcher 监控函数的状态。

要使用专用的线程池，可以传递 QThreadPool 作为第一个参数：

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

将参数传递给函数

将参数传递给函数，是通过将它们添加到 QtConcurrent::run() 直接调用在函数名之后。例如：

extern void aFunctionWithArguments(int arg1, double arg2, const QString &string);

int integer = ...;
double floatingPoint = ...;
QString string = ...;

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

每个参数的副本在调用 QtConcurrent::run() 的时候产生，当函数开始执行时，这些值被传递给线程。调用 QtConcurrent::run() 后对参数所做的更改对线程不可见。

从函数返回值

该函数的任何返回值都可以通过 QFuture 可见：

extern QString functionReturningAString();
QFuture<QString> future = QtConcurrent::run(functionReturningAString);
...
QString result = future.result();

正如上面记录的，传递参数是这样的：

extern QString someFunction(const QByteArray &input);

QByteArray bytearray = ...;

QFuture<QString> future = QtConcurrent::run(someFunction, bytearray);
...
QString result = future.result();

注意： QFuture::result() 函数阻塞并等待结果可用。当函数执行完成并且结果可用时，使用 QFutureWatcher 获取通知。

附加 API 功能

使用成员函数

QtConcurrent::run() 也接受指向成员函数的指针，第一个参数必须是 const 引用或指向类的实例的指针。在调用 const 成员函数时，const 引用的传递是很有用的，传递指针对于调用修改实例的非 const 成员函数非常有用。

例如，在单独的线程中调用 QByteArray::split()（一个 const 成员函数）是这样做的：

// 在一个单独的线程中调用 QList<QByteArray> QByteArray::split(char sep) const
QByteArray bytearray = "hello world";
QFuture<QList<QByteArray> > future = QtConcurrent::run(bytearray, &QByteArray::split, ',');
...
QList<QByteArray> result = future.result();

调用非 const 成员函数是这样完成的：

// 在一个单独的线程中调用 void QImage::invertPixels(InvertMode mode) 
QImage image = ...;
QFuture<void> future = QtConcurrent::run(&image, &QImage::invertPixels, QImage::InvertRgba);
...
future.waitForFinished();
// 此时，image 中的像素已经被反转

使用绑定函数参数

在调用时，可以使用 std::bind() 将一些参数绑定到函数。如果 C++11 支持不可用，boost::bind() 或 std::tr1::bind() 是合适的替代品。

有许多绑定的原因：

• 调用需要超过 5 个参数的函数
• 简化使用常量参数调用函数
• 更改参数的顺序

调用绑定函数是这样做的：

void someFunction(int arg1, double arg2);
QFuture<void> future = QtConcurrent::run(std::bind(someFunction, 1, 2.0));
...

有关如何使用绑定 API 的详细信息，请参阅相关函数的文档。

更多参考

• Qt之Concurrent框架
• Qt之Concurrent Map和Map-Reduce
• Qt之Concurrent Filter和Filter-Reduce
• Qt之QFuture
• Qt之QFutureWatcher