std::future

在标头 `<future>` 定义
template< class T > class future;	(1)	(C++11 起)
template< class T > class future<T&>;	(2)	(C++11 起)
template<> class future<void>;	(3)	(C++11 起)

类模板 std::future 提供访问异步操作结果的机制：

（通过 std::async、std::packaged_task 或 std::promise 创建的）异步操作能提供一个 std::future 对象给该异步操作的创建者。

然后，异步操作的创建者可以使用多个方法查询、等待或从 std::future 提取值。若异步操作尚未提供值，则这些方法可能阻塞。

当异步操作准备好发送结果给创建者时，它可以修改与创建者的 std::future 相链接的共享状态（例如 std::promise::set_value）。

注意，std::future 所引用的共享状态不与另一异步返回对象共享（与 std::shared_future 相反）。

成员函数

(构造函数)	构造未来体对象 (公开成员函数)
(析构函数)	析构未来体对象 (公开成员函数)
operator=	移动未来体对象 (公开成员函数)
share	从 `*this` 转移共享状态给 `shared_future` 并返回它 (公开成员函数)
获取结果
get	返回结果 (公开成员函数)
状态
valid	检查未来体是否拥有共享状态 (公开成员函数)
wait	等待结果变得可用 (公开成员函数)
wait_for	等待结果，如果在指定的超时间隔后仍然无法得到结果，则返回。 (公开成员函数)
wait_until	等待结果，如果在已经到达指定的时间点时仍然无法得到结果，则返回。 (公开成员函数)

示例

运行此代码

#include <future>
#include <iostream>
#include <thread>
 
int main()
{
    // 来自 packaged_task 的 future
    std::packaged_task<int()> task([](){ return 7; }); // 包装函数
    std::future<int> f1 = task.get_future();  // 获取 future
    std::thread t(std::move(task)); // 在线程上运行
 
    // 来自 async() 的 future
    std::future<int> f2 = std::async(std::launch::async, [](){ return 8; });
 
    // 来自 promise 的 future
    std::promise<int> p;
    std::future<int> f3 = p.get_future();
    std::thread([&p]{ p.set_value_at_thread_exit(9); }).detach();
 
    std::cout << "等待..." << std::flush;
    f1.wait();
    f2.wait();
    f3.wait();
    std::cout << "完成!\n结果为: "
              << f1.get() << ' ' << f2.get() << ' ' << f3.get() << '\n';
    t.join();
}

输出：

等待...完成!
结果为: 7 8 9

带异常的示例

运行此代码

#include <future>
#include <iostream>
#include <thread>
 
int main()
{
    std::promise<int> p;
    std::future<int> f = p.get_future();
 
    std::thread t([&p]
    {
        try
        {
            // 可能抛出异常的代码
            throw std::runtime_error("Example");
        }
        catch (...)
        {
            try
            {
                // 存储 promise 中抛出的任何异常
                p.set_exception(std::current_exception());
            }
            catch (...) {} // set_exception() 也可能抛出异常
        }
    });
 
    try
    {
        std::cout << f.get();
    }
    catch (const std::exception& e)
    {
        std::cout << "来自线程的异常: " << e.what() << '\n';
    }
    t.join();
}

输出：

来自线程的异常: Example

参阅

async (C++11)	异步运行一个函数（有可能在新线程中执行），并返回将保有它的结果的 std::future (函数模板)
shared_future (C++11)	等待一个被异步设置的值（可能被其他未来体引用） (类模板)

编译器支持
自立实现与有宿主实现
语言
标准库
标准库标头
具名要求
功能特性测试宏 (C++20)
语言支持库
概念库 (C++20)
元编程库 (C++11)
诊断库
通用工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
并发支持库 (C++11)
技术规范
符号索引
外部库

future::future
future::~future
future::operator=
future::share
获取结果
future::get
状态
future::valid
future::wait
future::wait_for
future::wait_until

std::future

成员函数

获取结果

状态

示例

带异常的示例

参阅

导航