QtFuture 弃用的成员

下面是类 QtFuture 中弃用的成员。 它们提供以保持旧源代码的正常工作。我们强烈建议不要在新的代码中使用它们。

函数

函数文档

[since 6.1, deprecated in 6.6] 模板 <typename T, typename = QtPrivate::EnableForNonVoid<T>> QFuture<std::decay_t<T>> QtFuture::makeReadyFuture(T &&value)

该函数自 6.6 起已弃用。我们强烈建议不要在新代码中使用它。

这是一个重载函数。

请使用 makeReadyValueFuture() 代替。

创建并返回一个已有一个结果值 value 的 QFuture。返回的 QFuture 类型为 std::decay_t<T>，其中 T 不是 void。

auto f = QtFuture::makeReadyFuture(std::make_unique<int>(42));
...
const int result = *f.takeResult(); // result == 42

应避免使用此方法，因为它有一系列不一致的重载。从 Qt 6.10 开始，在代码中使用它将导致编译器警告。

此函数是在 Qt 6.1 中引入的。

另请参阅QFuture、QtFuture::makeReadyVoidFuture、QtFuture::makeReadyValueFuture、QtFuture::makeReadyRangeFuture 和 QtFuture::makeExceptionalFuture。

[since 6.1, deprecated in 6.6] 模板 <typename T> QFuture<T> QtFuture::makeReadyFuture(const QList<T> &values)

该函数自 6.6 起已弃用。我们强烈建议不要在新代码中使用它。

这是一个重载函数。

请使用 makeReadyRangeFuture() 代替。

创建并返回已从 values 中设置多个结果集的 QFuture。

const QList<int> values { 1, 2, 3 };
auto f = QtFuture::makeReadyFuture(values);
...
const int count = f.resultCount(); // count == 3
const auto results = f.results(); // results == { 1, 2, 3 }

应避免使用此方法，因为它有一系列不一致的重载。从 Qt 6.10 开始，在代码中使用它将导致编译器警告。

此函数是在 Qt 6.1 中引入的。

另请参阅QFuture、QtFuture::makeReadyVoidFuture、QtFuture::makeReadyValueFuture、QtFuture::makeReadyRangeFuture 和 QtFuture::makeExceptionalFuture。

[since 6.1, deprecated in 6.6] QFuture<void> QtFuture::makeReadyFuture()

该函数自 6.6 起已弃用。我们强烈建议不要在新代码中使用它。

这是一个重载函数。

请使用 makeReadyVoidFuture() 代替。

创建并返回一个空的QFuture。这种QFuture不能存储任何结果。可以用它来查询计算的进度。返回的QFuture总是处于完成状态。

auto f = QtFuture::makeReadyFuture();
...
const bool started = f.isStarted(); // started == true
const bool running = f.isRunning(); // running == false
const bool finished = f.isFinished(); // finished == true

应避免使用此方法，因为它有一系列不一致的重载。从 Qt 6.10 开始，在代码中使用它将导致编译器警告。

此函数是在 Qt 6.1 中引入的。

另请参阅：QFuture、QFuture::isStarted()、QFuture::isRunning()、QFuture::isFinished()、QtFuture::makeReadyVoidFuture()、QtFuture::makeReadyValueFuture()、QtFuture::makeReadyRangeFuture()和QtFuture::makeExceptionalFuture()。