std::future<T>::wait_for
来自 cppreference.cn
| template< class Rep, class Period > std::future_status wait_for( const std::chrono::duration<Rep,Period>& timeout_duration ) const; |
(C++11 起) | |
等待结果可用。阻塞直到指定的 timeout_duration 已过去或结果可用，以先发生者为准。返回值标识结果的状态。
如果 future 是通过 std::async 调用并使用惰性求值（lazy evaluation）获得的结果，此函数将立即返回而不等待。
由于调度或资源竞争延迟，此函数可能会阻塞超过 timeout_duration 的时间。
标准建议使用稳定时钟来测量持续时间。如果实现使用系统时钟，则等待时间也可能对时钟调整敏感。
如果在调用此函数之前 valid() 为 false，则行为未定义。
目录 |
[编辑] 参数
| timeout_duration | - | 最大阻塞持续时间 |
[编辑] 返回值
| 常量 | 解释 |
| future_status::deferred | 共享状态包含使用延迟评估的延迟函数，因此只有在明确请求时才会计算结果 |
| future_status::ready | 结果已就绪 |
| future_status::timeout | 超时已过期 |
[编辑] 异常
在执行过程中，时钟 (clock)、时间点 (time_point) 或持续时间 (duration) 抛出的任何异常（标准库提供的时钟、时间点和持续时间永远不会抛出异常）。
[编辑] 注意
鼓励实现检测在调用前 valid == false 的情况，并抛出带有错误条件 std::future_errc::no_state 的 std::future_error。
[编辑] 示例
运行此代码
#include <chrono> #include <future> #include <iostream> #include <thread> using namespace std::chrono_literals; int main() { std::future<int> future = std::async(std::launch::async, []() { std::this_thread::sleep_for(3s); return 8; }); std::cout << "waiting...\n"; std::future_status status; do { switch (status = future.wait_for(1s); status) { case std::future_status::deferred: std::cout << "deferred\n"; break; case std::future_status::timeout: std::cout << "timeout\n"; break; case std::future_status::ready: std::cout << "ready!\n"; break; } } while (status != std::future_status::ready); std::cout << "result is " << future.get() << '\n'; }
可能的输出
waiting... timeout timeout timeout ready! result is 8
[编辑] 另请参阅
| 等待结果可用 (公共成员函数) | |
| 等待结果，如果到指定时间点仍不可用则返回 (公共成员函数) |
