簡述

QtConcurrent::run() 函式在一個單獨的執行緒中執行一個函式， 函式的返回值通過 QFuture 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 的詳細資訊，請參閱相關函式的文件。

更多參考