std::shared_future<T>::wait_until
来自 cppreference.com
< cpp | thread | shared future
template< class Clock, class Duration > std::future_status wait_until( const std::chrono::time_point<Clock,Duration>& timeout_time ) const; |
(自 C++11 起) | |
wait_until
等待结果可用。它会阻塞,直到指定的 timeout_time 到达或结果可用,以先发生者为准。返回值指示 wait_until
返回的原因。
如果期货是调用 async(使用延迟评估)的结果,则此函数会立即返回,而不会等待。
如果在调用此函数之前 valid() 为 false,或者 Clock
不满足 Clock 要求,则行为未定义。 如果 std::chrono::is_clock_v<Clock> 为 false,则程序格式错误。(自 C++20 起)
内容 |
[编辑] 参数
timeout_time | - | 最大阻塞时间点 |
[编辑] 返回值
常量 | 解释 |
future_status::deferred | 共享状态包含使用延迟评估的延迟函数,因此结果只有在显式请求时才会计算 |
future_status::ready | 结果已准备就绪 |
future_status::timeout | 超时已过期 |
[编辑] 异常
执行期间由时钟、时间点或持续时间抛出的任何异常(标准库提供的时钟、时间点和持续时间从不抛出异常)。
[编辑] 注意
鼓励实现检测 valid() == false 在调用之前并抛出 std::future_error,其错误条件为 future_errc::no_state.
标准建议将与 timeout_time 绑定的时钟用于测量时间;该时钟不需要是单调时钟。如果时钟不连续调整,则此函数的行为没有保证,但现有实现将 timeout_time 从 Clock
转换为 std::chrono::system_clock 并委托给 POSIX pthread_cond_timedwait
,以便等待尊重对系统时钟的调整,但不尊重用户提供的 Clock
。无论如何,该函数也可能等待的时间超过 timeout_time 到达之后,因为调度或资源争用延迟。
[编辑] 示例
本节不完整 原因:没有示例 |
[编辑] 另请参阅
等待结果可用 (公共成员函数) | |
等待结果,如果在指定超时持续时间内不可用,则返回 (公共成员函数) |