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)

构造 QFutureSynchronizer，并通过调用addFuture() 开始监视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 为真，则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()。