std::execution::ensure_started

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

执行控制库

执行概念 scheduler receiver receiver_of operation_state    sender 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 起)

参数

sender

-

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

返回值

返回一个发送器，于所提供的 sender 完成时完成，并产生等价于所提供的 sender 所产生的值。

注解

• 一旦 ensure_started 返回，即可知所提供的 sender 已经连接，且已在所产生的操作状态上调用了 start。换言之，已将所提供的 sender 所描述的工作提交给相应执行资源予以执行。

• 如果所返回的发送器在调用 execution::connect() 前被销毁，或如果调用了 execution::connect() 但所返回的操作状态在调用 execution::start() 前被销毁，则向急切发起的操作发送一个停止请求，并且这个操作被脱离并将在背景中运行直至完成。

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

• 注意，应用程序将需要确保操作脱离的情况中的各项资源持续存活（如通过持有到这些资源的 std::shared_ptr）。