std::execution::ensure_started

 

C++

编译器支持

独立和宿主

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

执行库

执行概念 调度程序 接收器 receiver_of 操作状态    发送器 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 已连接，并且已在生成的 operation state 上调用 start。换句话说，提供的 sender 所描述的工作已提交到相应的执行资源上执行。

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

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

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