std::execution::read_env

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

执行库

执行概念 调度器 接收器 接收器_of 操作状态    发送器 发送器_in 发送器_to 执行组件 执行上下文 run_loop 执行域 default_domain 前进保证 forward_progress_guarantee 环境 empty_env    get_env    env_of_t 查询 std::stop_token_of_t std::get_stop_token std::get_allocator std::forwarding_query get_scheduler get_domain get_forward_progress_guarantee get_delegation_scheduler get_completion_scheduler 完成签名 completion_signatures completion_signatures_of_t transform_completion_signatures transform_completion_signatures_of    value_types_of_t error_types_of_t    tag_of_t sends_stopped    发送器适配器闭包 sender_adaptor_closure 协程实用程序 as_awaitable with_awaitable_senders

核心操作 操作状态 connect connect_result_t start 完成 set_value set_error set_stopped 转换 transform_env transform_sender apply_sender 发送器算法 发送器工厂 just just_error just_stopped read_env schedule schedule_result_t 发送器适配器 starts_on continues_on    on then upon_error upon_stopped let_value let_error let_stopped schedule_from when_all when_all_with_variant into_variant stopped_as_optional stopped_as_error bulk split 发送器消费者 this_thread::sync_wait this_thread::sync_wait_with_variant

 

定义在头文件 <execution> 中
inline constexpr /*unspecified*/ read_env{};		(自 C++26 起) (定制点对象)
调用签名
execution::sender auto read_env( auto&& query );		(自 C++26 起)

一个发送器工厂，返回一个发送器，它深入接收器的环境中，并提取与给定 查询对象 关联的当前值。

对于任何查询对象 q，表达式 read_env(q) 与 /*make-sender*/(read_env, q) 表达式等价。

定制点对象

名称 execution::read_env 表示一个定制点对象，它是一个 const 函数对象，属于一个 字面量 semiregular 类类型。出于解释目的，其类型的 cv-无限定版本表示为 __read_env_fn。

所有 __read_env_fn 的实例都是相等的。无论表达式表示的实例是左值还是右值，以及是否进行 const 限定，调用类型为 __read_env_fn 的不同实例在相同参数上的效果都是等效的（但是，不需要调用 volatile 限定的实例）。因此，execution::read_env 可以自由复制，并且可以互换使用其副本。

给定一组类型 Args...，如果 std::declval<Args>()... 满足上述对 execution::read_env 参数的要求，__read_env_fn 模仿

• std::invocable<__read_env_fn, Args...>,
• std::invocable<const __read_env_fn, Args...>,
• std::invocable<__read_env_fn&, Args...>，以及
• std::invocable<const __read_env_fn&, Args...>.
  

否则，__read_env_fn 的任何函数调用运算符都不会参与重载解析。

示例

此工厂的一个示例用法是在接收器的调度器上调度依赖工作，可以使用 read_env(get_scheduler) 获取调度器。

std::execution::sender auto task =
  std::execution::read_env(std::execution::get_scheduler)
    | std::execution::let_value([](auto sched) {
        return std::execution::starts_on(sched, /*some nested work here*/);
    });
 
std::this_thread::sync_wait( std::move(task) ); // wait for it to finish