简述
QtConcurrent::run() 函数在一个单独的线程中运行一个函数, 函数的返回值通过 QFuture API 提供。
该函数是 Qt之Concurrent框架 的一部分。
简述
在单独的线程中运行函数
将参数传递给函数
从函数返回值
附加 API 功能
使用成员函数
使用绑定函数参数
更多参考
在单独的线程中运行函数
要在另一个线程中运行函数,使用 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