std::promise<R>::get_future

来自cppreference.com
< cpp‎ | thread‎ | promise
 
C++
 
并发支持库
线程
(C++11)
(C++20)
(C++20)
(C++20)
(C++20)
(C++17)(C++17)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
(C++11)
互斥
(C++11)
(C++11)  
(C++17)
通用锁管理
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(C++11)
(C++11)
(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++20)
(C++20)
未来体
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
(C++26)
(C++26)  
(C++26)
(C++26)
(C++26)
风险指针
(C++26)
(C++26)
(C++26)





原子类型
(C++11)
(C++20)
(C++11)
原子类型的初始化
(C++11)(C++20 中弃用)
(C++11)(C++20 中弃用)
(C++11)
内存定序
(C++11)
(C++11)
(C++11)
(C++11)
原子操作的自由函数
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子标志的自由函数
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
 
std::promise
 
std::future<R> get_future();
 (C++11 起)

返回与 *this 关联同一状态的未来体对象。

若 *this 无共享状态或已调用 get_future，则抛出异常。可使用 std::future::share 以获取承诺体-未来体交流通道的多个“弹出”端。

对此函数的调用与对 set_value、set_exception、set_value_at_thread_exit 或 set_exception_at_thread_exit 的调用不造成数据竞争（但它们不必彼此同步）。

参数

（无）

返回值

指代 *this 的共享状态的未来体。

异常

遇到下列条件时抛出 std::future_error：

  • *this 无共享状态。设置错误码为 no_state。
  • 已在与 *this 拥有同一共享状态的承诺体上调用过 get_future()。设置错误码为 future_already_retrieved。
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/thread/promise/get_future&oldid=88809”