std::execution::ensure_started

 

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>
execution::sender auto ensure_started( execution::sender auto sender );		(C++26 起)

参数

发送器

-

输入发送器，其停止通道被映射到 err

返回值

返回一个发送器，当提供的 sender 完成时，该发送器也完成，并发送与提供的 sender 等效的值。

注意

• 一旦 ensure_started 返回，就知道提供的 sender 已经连接，并且已对生成的操作状态调用了 start。换句话说，提供的 sender 描述的工作已提交给适当的执行资源进行执行。

• 如果在调用 execution::connect() 之前销毁返回的发送器，或者如果调用了 execution::connect() 但在调用 execution::start() 之前销毁了返回的操作状态，则会向急切启动的操作发送停止请求，操作将被分离并在后台运行直至完成。

• 在这种情况下，操作的结果在最终完成后将被丢弃。

• 请注意，如果操作分离（例如通过持有这些资源的 std::shared_ptr），应用程序将需要确保资源保持活动状态。