std::experimental::when_any

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

实验性

技术规范

文件系统库 (文件系统 TS)

库基础 (库基础 TS)

库基础 2 (库基础 TS v2)

库基础 3 (库基础 TS v3)

并行扩展 (并行 TS)

并行扩展 2 (并行 TS v2)

并发扩展 (并发 TS)

并发扩展 2 (并发 TS v2)

概念 (概念 TS)

范围 (范围 TS)

反射 (反射 TS)

数学特殊函数 (特殊函数 TR)

实验性非 TS

模式匹配

线性代数

std::execution

契约

二维图形

 

并发扩展

std::future 扩展

experimental::future

experimental::shared_future

experimental::when_all

experimental::when_any

experimental::make_ready_future

experimental::make_exceptional_future

闩锁和屏障

experimental::latch

experimental::barrier

experimental::flex_barrier

原子智能指针

experimental::atomic_shared_ptr

experimental::atomic_weak_ptr

 

定义在头文件 <experimental/future> 中
template< class Sequence > struct when_any_result {     std::size_t index;     Sequence futures; };		(并发 TS)
template< class InputIt > auto when_any( InputIt first, InputIt last )     -> future<when_any_result<std::vector<typename std::iterator_traits<InputIt>::value_type>>>;	(1)	(并发 TS)
template< class... Futures > auto when_any( Futures&&... futures )     -> future<when_any_result<std::tuple<std::decay_t<Futures>...>>>;	(2)	(并发 TS)

创建一个 future 对象，当至少一个输入 future 和 shared_future 就绪时，该对象就绪。如果任何输入 future 或 shared_future 无效，则行为未定义。

特别是，令 Sequence 为 std::vector<typename std::iterator_traits<InputIt>::value_type> 用于 (1) 和 std::tuple<std::decay_t<Futures>...> 用于 (2)。此函数模板创建包含 when_any_result<Sequence> 的共享状态，并返回引用共享状态的 future。每个输入 future 都被移入 when_any_result<Sequence> 中共享状态的 futures 成员中的对应对象，并且每个输入 shared_future 都被复制到 when_any_result<Sequence> 中共享状态的 futures 成员中的对应对象。Sequence 中对象的顺序与参数的顺序匹配。

1) 除非 InputIt 的值类型（即 typename std::iterator_traits<InputIt>::value_type）为 std::experimental::future 或 std::experimental::shared_future，否则此函数不参与重载解析。

2) 除非每个参数都是（可能 cv 限定的）std::experimental::shared_future 或 cv 未限定的 std::experimental::future，否则此函数不参与重载解析。（形式上，对于 Futures 中的每个类型 Fn，要么 std::remove_reference_t<Fn> 为 std::experimental::future<Rn>，要么 std::decay_t<Fn> 为 std::experimental::shared_future<Rn>。）

在此调用之后，每个输入 future 将不再有效；每个输入 shared_future 保持有效。

返回值

引用由调用创建的共享状态的 future。future 始终为 valid()，并且当至少一个输入 future 和 shared_future 调用就绪时，该 future 就绪。when_any_result 的 index 成员包含就绪 future 或 shared_future 在 futures 成员中的位置。

1) 如果范围为空（即 first == last），则返回的 future 立即就绪；when_any_result 的 futures 字段为空向量，并且 index 字段为 size_t(-1)。

2) 如果未提供任何参数，则返回的 future 立即就绪；when_any_result 的 futures 字段为空元组，并且 index 字段为 size_t(-1)。