命名空间
变体
操作

std::shared_future<T>::wait_until

来自 cppreference.cn
 
 
并发支持库
线程
(C++11)
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
协作取消
互斥
(C++11)
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
条件变量
(C++11)
信号量
闩锁和屏障
(C++20)
(C++20)
期值
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
Hazard 指针
原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中已弃用)
(C++11)(C++20 中已弃用)
内存顺序
(C++11)(C++26 中已弃用)
原子操作的自由函数
原子标志的自由函数
 
 
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 返回的原因。

如果 future 是调用 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 超时已过期

[编辑] 异常

时钟、time_point 或 duration 在执行期间抛出的任何异常(标准库提供的时钟、时间点和 duration 永远不会抛出异常)。

[编辑] 注解

鼓励实现检测在调用之前 valid() == false 的情况,并抛出带有错误条件 future_errc::no_statestd::future_error

标准建议绑定到 timeout_time 的时钟用于测量时间;该时钟不需要是单调时钟。如果时钟不连续调整,则此函数的行为没有保证,但现有实现将 timeout_timeClock 转换为 std::chrono::system_clock 并委托给 POSIX pthread_cond_timedwait,以便等待尊重对系统时钟的调整,但不尊重对用户提供的 Clock 的调整。在任何情况下,由于调度或资源争用延迟,该函数也可能等待比到达 timeout_time 之后更长的时间。


[编辑] 示例

[编辑] 参见

等待结果变为可用
(公共成员函数) [编辑]
等待结果,如果在指定的超时持续时间内不可用则返回
(公共成员函数) [编辑]