QFutureSynchronizer Class

void someFunction()
{
    QFutureSynchronizer<void> synchronizer;

    //...

    synchronizer.addFuture(QtConcurrent::run(anotherFunction));
    synchronizer.addFuture(QtConcurrent::map(list, mapFunction));

    return; // QFutureSynchronizer waits for all futures to finish
}

成员函数文档

QFutureSynchronizer::QFutureSynchronizer()

创建一个 QFutureSynchronizer。

[explicit] QFutureSynchronizer::QFutureSynchronizer(QFuture<T> future)

通过调用addFuture() 方法，构建一个 QFutureSynchronizer 并开始监听future 。

另请参阅 addFuture()。

QFutureSynchronizer::~QFutureSynchronizer()

调用waitForFinished() 函数，以确保在销毁此QFutureSynchronizer 之前，所有未来对象均已完成执行。

另请参阅 waitForFinished()。

void QFutureSynchronizer::addFuture(QFuture<T> future)

将future 添加到管理期货列表中。

另请参阅 futures()。

bool QFutureSynchronizer::cancelOnWait() const

如果启用了“等待时取消”功能，则返回true ；否则返回false。如果启用了“等待时取消”功能，waitForFinished() 函数将在等待未来对象完成之前取消所有未来对象。

另请参阅 setCancelOnWait() 和waitForFinished()。

void QFutureSynchronizer::clearFutures()

从该QFutureSynchronizer 中移除所有管理型期货。

另请参阅 addFuture() 和setFuture()。

QList<QFuture<T>> QFutureSynchronizer::futures() const

返回所有管理型期货的列表。

另请参阅 addFuture() 和setFuture()。

void QFutureSynchronizer::setCancelOnWait(bool enabled)

根据enabled 参数启用或禁用“等待时取消”功能。如果enabled 为true，则waitForFinished()函数会在等待未来对象完成之前取消所有未来对象。

另请参阅 cancelOnWait() 和waitForFinished()。

void QFutureSynchronizer::setFuture(QFuture<T> future)

将 `future ` 设置为该 `QFutureSynchronizer` 管理的唯一未来。这是一个便捷函数，它依次调用 `waitForFinished()`、`clearFutures()`，最后将 `future ` 传递给 `addFuture()`。

另请参阅 addFuture()、waitForFinished() 以及clearFutures()。

void QFutureSynchronizer::waitForFinished()

等待所有未来任务完成。如果 `cancelOnWait()` 返回 `true`，则在等待未来任务完成之前，每个未来任务都会被取消。

另请参阅 cancelOnWait() 和setCancelOnWait()。