std::execution::just_error

 

C++

编译器支持

自由（freestanding）与宿主（hosted）

语言

标准库

标准库头文件

具名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

执行控制库

执行概念 调度器 接收器 receiver_of operation_state    发送器 sender_in sender_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 just_error_t just_error{}; struct just_error_t { /*unspecified*/ };		(C++26 起) (定制点对象)
调用签名 (Call signature)
execution::sender auto just_error( auto&& error );		(C++26 起)

一个 sender 工厂，它返回一个 sender，该 sender 通过调用 receiver 的 set_error() 立即完成。

令 e 为一个子表达式，它表示一个将被注入并由 receiver 返回的输入错误。表达式 just_error(e) 表达式等价于 /*make-sender*/(just_error, /*product-type*/(e))

自定义点对象

名称 execution::just_error 表示一个自定义点对象，它是一个 const 函数对象，属于 字面量 semiregular 类类型。其 cv-unqualified 版本是一种标签类型，表示为 execution::just_error_t。

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

给定一组类型 Args...，如果 std::declval<Args>()... 满足上述 execution::just_error 的参数要求，则 execution::just_error_t 满足

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

否则，execution::just_error_t 的任何函数调用运算符都不参与重载决议。

注意

如果提供的错误是左值引用，则在返回的 sender 内部会进行一次复制，并将该复制的非 const 左值引用发送到 receiver 的 set_error。如果提供的值是右值引用，它将被移动到返回的 sender 中，并将其右值引用发送到 receiver 的 set_error。