C++ 参考手册

See More

位置：首页 > C++ 参考手册 >线程支持库 > std::future

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 相反）。

成员函数

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

示例

运行此代码
#include <iostream>
#include <future>
#include <thread>
 
int main()
{
    // 来自 packaged_task 的 future
    std::packaged_task<int()> task([](){ return 7; }); // 包装函数
    std::future<int> f1 = task.get_future();  // 获取 future
    std::thread(std::move(task)).detach(); // 在线程上运行
 
    // 来自 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 << "Waiting..." << std::flush;
    f1.wait();
    f2.wait();
    f3.wait();
    std::cout << "Done!\nResults are: "
              << f1.get() << ' ' << f2.get() << ' ' << f3.get() << '\n';
}

输出： 

Waiting...Done!
Results are: 7 8 9

参阅

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