std::future
来自cppreference.com
定义于头文件 <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 所引用) (类模板) |