命名空间
变体
操作

std::future<T>::wait_until

来自 cppreference.cn
< cpp‎ | thread‎ | future
 
 
并发支持库
线程
(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)
危险指针
原子类型
(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 超时已过期

[编辑] 异常

在执行过程中,时钟 (clock)、时间点 (time_point) 或持续时间 (duration) 抛出的任何异常(标准库提供的时钟、时间点和持续时间永远不会抛出异常)。

[编辑] 注意

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

标准建议使用与 timeout_time 绑定的时钟来测量时间;该时钟不要求是单调时钟。如果时钟不连续调整,则此函数的行为不作保证,但现有实现将 Clock 中的 timeout_time 转换为 std::chrono::system_clock 并委托给 POSIX pthread_cond_timedwait,以便等待遵守系统时钟的调整,但不遵守用户提供的 Clock。无论如何,由于调度或资源争用延迟,该函数也可能等待超过 timeout_time 之后的时间。


[编辑] 示例

#include <chrono>
#include <future>
#include <iostream>
#include <thread>
 
int main()
{
    std::chrono::system_clock::time_point two_seconds_passed
        = std::chrono::system_clock::now() + std::chrono::seconds(2);
 
    // Make a future that takes 1 second to complete
    std::promise<int> p1;
    std::future<int> f_completes = p1.get_future();
    std::thread([](std::promise<int> p1)
                { 
                    std::this_thread::sleep_for(std::chrono::seconds(1)); 
                    p1.set_value_at_thread_exit(9); 
                }, 
                std::move(p1)
    ).detach();
 
    // Make a future that takes 5 seconds to complete
    std::promise<int> p2;
    std::future<int> f_times_out = p2.get_future();
    std::thread([](std::promise<int> p2)
                { 
                    std::this_thread::sleep_for(std::chrono::seconds(5)); 
                    p2.set_value_at_thread_exit(8); 
                }, 
                std::move(p2)
    ).detach();
 
    std::cout << "Waiting for 2 seconds..." << std::endl;
 
    if (std::future_status::ready == f_completes.wait_until(two_seconds_passed))
        std::cout << "f_completes: " << f_completes.get() << "\n";
    else
        std::cout << "f_completes did not complete!\n";
 
    if (std::future_status::ready == f_times_out.wait_until(two_seconds_passed))
        std::cout << "f_times_out: " << f_times_out.get() << "\n";
    else
        std::cout << "f_times_out did not complete!\n";
 
    std::cout << "Done!\n";
}

可能的输出

Waiting for 2 seconds...
f_completes: 9
f_times_out did not complete!
Done!

[编辑] 另请参阅

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