Standard library header <execution> (C++17)
From cppreference.net
此头文件属于 execution 与 algorithm 库的组成部分。
类 |
||
|
(C++17)
|
测试一个类是否表示执行策略
(类模板) |
|
|
定义于命名空间
std::execution
|
||
|
(C++17)
(C++17)
(C++17)
(C++20)
|
执行策略类型
(类) |
|
常量 |
||
|
定义于命名空间
std::execution
|
||
|
(C++17)
(C++17)
(C++17)
(C++20)
|
全局执行策略对象
(常量) |
|
|
本节内容尚不完整
原因:缺少执行库子页面的链接 |
概要
namespace std { // execution policy type trait template<class T> struct is_execution_policy; // freestanding template<class T> constexpr bool is_execution_policy_v = is_execution_policy<T>::值; // freestanding } namespace std::执行 { // 顺序执行策略 class sequenced_policy; // 并行执行策略 class parallel_policy; // 并行且无序执行策略 class parallel_unsequenced_policy; // 无序执行策略 class unsequenced_policy; // execution policy objects inline constexpr sequenced_policy seq{ /* 未指定 */ }; inline constexpr parallel_policy par{ /* 未指定 */ }; inline constexpr parallel_unsequenced_policy par_unseq{ /* 未指定 */ }; inline constexpr unsequenced_policy unseq{ /* 未指定 */ }; } namespace std { // helper concepts template<class T> concept /*movable-value*/ = /* 查看描述 */; // 仅作展示用途 template<class From, class To> concept /*衰减为*/ = same_as<decay_t<From>, To>; // 仅作展示用途 template<class T> concept /*类类型*/ = /*衰减为*/<T, T> && is_class_v<T>; // 仅作展示用途 // 可查询对象 template<class T> concept /*queryable*/ = /* 查看描述 */; // 仅作展示用途 // queries struct forwarding_query_t { /* 未指定 */ }; struct get_allocator_t { /* 未指定 */ }; struct get_stop_token_t { /* 未指定 */ }; inline constexpr forwarding_query_t forwarding_query{}; inline constexpr get_allocator_t get_allocator{}; inline constexpr get_stop_token_t get_stop_token{}; template<class T> using stop_token_of_t = remove_cvref_t<decltype(get_stop_token(declval<T>()))>; template<class T> concept /*forwarding-query*/ = forwarding_query(T{}); // 仅作展示用途 } namespace std::执行 { // queries struct get_domain_t { /* 未指定 */ }; struct get_scheduler_t { /* 未指定 */ }; struct get_delegation_scheduler_t { /* 未指定 */ }; struct get_forward_progress_guarantee_t { /* 未指定 */ }; template<class CPO> struct get_completion_scheduler_t { /* 未指定 */ }; inline constexpr get_domain_t get_domain{}; inline constexpr get_scheduler_t get_scheduler{}; inline constexpr get_delegation_scheduler_t get_delegation_scheduler{}; enum class forward_progress_guarantee; inline constexpr get_forward_progress_guarantee_t get_forward_progress_guarantee{}; template<class CPO> constexpr get_completion_scheduler_t<CPO> get_completion_scheduler{}; struct get_env_t { /* 未指定 */ }; inline constexpr get_env_t get_env{}; template<class T> using env_of_t = decltype(get_env(declval<T>())); template<class QueryTag, class ValueType> struct prop; template</*queryable*/... Envs> struct env; // 执行域 struct default_domain; // 调度器 struct scheduler_t {}; template<class Sch> concept scheduler = /* 查看描述 */; // 接收器 struct receiver_t {}; template<class Rcvr> concept receiver = /* 查看描述 */; template<class Rcvr, class Completions> concept receiver_of = /* 查看描述 */; struct set_value_t { /* 未指定 */ }; struct set_error_t { /* 未指定 */ }; struct set_stopped_t { /* 未指定 */ }; inline constexpr set_value_t set_value{}; inline constexpr set_error_t set_error{}; inline constexpr set_stopped_t set_stopped{}; // 操作状态 struct operation_state_t {}; template<class O> concept operation_state = /* 查看描述 */; struct start_t; inline constexpr start_t start{}; // 发送器 struct sender_t {}; template<class Sndr> concept sender = /* 查看描述 */; template<class Sndr, class Env = env<>> concept sender_in = /* 查看描述 */; template<class Sndr, class Rcvr> concept sender_to = /* 查看描述 */; template<class... Ts> struct /*type-list*/; // 仅作展示用途 // completion signatures struct get_completion_signatures_t; inline constexpr get_completion_signatures_t get_completion_signatures{}; template<class Sndr, class Env = env<>> requires sender_in<Sndr, Env> using completion_signatures_of_t = /*call-result-t*/<get_completion_signatures_t, Sndr, Env>; template<class... Ts> using /*decayed-tuple*/ = tuple<decay_t<Ts>...>; // 仅作展示用途 template<class... Ts> using /*variant-or-empty*/ = /* 查看描述 */; // 仅作展示用途 template<class Sndr, class Env = env<>, template<class...> class Tuple = /*decayed-tuple*/, template<class...> class Variant = /*variant-or-empty*/> requires sender_in<Sndr, Env> using value_types_of_t = /* 查看描述 */; template<class Sndr, class Env = env<>, template<class...> class Variant = /*variant-or-empty*/> requires sender_in<Sndr, Env> using error_types_of_t = /* 查看描述 */; template<class Sndr, class Env = env<>> requires sender_in<Sndr, Env> constexpr bool sends_stopped = /* 查看描述 */; template<class Sndr, class Env> using /*single-sender-value-type*/ = /* 查看描述 */; // 仅作展示用途 template<class Sndr, class Env> concept /*单发送方*/ = /* 查看描述 */; // 仅作展示用途 template<sender Sndr> using tag_of_t = /* 查看描述 */; // 发送方变换 template<class Domain, sender Sndr, /*queryable*/... Env> requires(sizeof...(Env) <= 1) constexpr sender decltype(auto) transform_sender( Domain dom, Sndr&& sndr, const Env&... env) noexcept(/* 查看描述 */); // 环境变换 template<class Domain, sender Sndr, /*queryable*/ Env> constexpr /*queryable*/ decltype(auto) transform_env(Domain dom, Sndr&& sndr, Env&& env) noexcept; // 发送方算法应用 template<class Domain, class Tag, sender Sndr, class... Args> constexpr decltype(auto) apply_sender(Domain dom, Tag, Sndr&& sndr, Args&&... args) noexcept(/* 查看描述 */); // 连接发送方算法 struct connect_t; inline constexpr connect_t connect{}; template<class Sndr, class Rcvr> using connect_result_t = decltype(connect(declval<Sndr>(), declval<Rcvr>())); // 发送器工厂 struct just_t { /* 未指定 */ }; struct just_error_t { /* 未指定 */ }; struct just_stopped_t { /* 未指定 */ }; struct schedule_t { /* 未指定 */ }; inline constexpr just_t just{}; inline constexpr just_error_t just_error{}; inline constexpr just_stopped_t just_stopped{}; inline constexpr schedule_t schedule{}; inline constexpr /* 未指定 */ read_env{}; template<scheduler Sndr> using schedule_result_t = decltype(schedule(declval<Sndr>())); // 发送器适配器 template</*类类型*/ D> struct sender_adaptor_closure {}; struct starts_on_t { /* 未指定 */ }; struct continues_on_t { /* 未指定 */ }; struct on_t { /* 未指定 */ }; struct schedule_from_t { /* 未指定 */ }; struct then_t { /* 未指定 */ }; struct upon_error_t { /* 未指定 */ }; struct upon_stopped_t { /* 未指定 */ }; struct let_value_t { /* 未指定 */ }; struct let_error_t { /* 未指定 */ }; struct let_stopped_t { /* 未指定 */ }; struct bulk_t { /* 未指定 */ }; struct split_t { /* 未指定 */ }; struct when_all_t { /* 未指定 */ }; struct when_all_with_variant_t { /* 未指定 */ }; struct into_variant_t { /* 未指定 */ }; struct stopped_as_optional_t { /* 未指定 */ }; struct stopped_as_error_t { /* 未指定 */ }; inline constexpr starts_on_t starts_on{}; inline constexpr continues_on_t continues_on{}; inline constexpr on_t on{}; inline constexpr schedule_from_t schedule_from{}; inline constexpr then_t then{}; inline constexpr upon_error_t upon_error{}; inline constexpr upon_stopped_t upon_stopped{}; inline constexpr let_value_t let_value{}; inline constexpr let_error_t let_error{}; inline constexpr let_stopped_t let_stopped{}; inline constexpr bulk_t bulk{}; inline constexpr split_t split{}; inline constexpr when_all_t when_all{}; inline constexpr when_all_with_variant_t when_all_with_variant{}; inline constexpr into_variant_t into_variant{}; inline constexpr stopped_as_optional_t stopped_as_optional{}; inline constexpr stopped_as_error_t stopped_as_error{}; // 发送方与接收方工具函数 template<class Fn> concept /*完成签名*/ = /* 查看描述 */; // 仅作展示用途 template</*完成签名*/... Fns> struct completion_signatures {}; template<class Sigs> concept /*有效完成签名*/ = /* 查看描述 */; // 仅作展示用途 template</*有效完成签名*/ InputSignatures, /*有效完成签名*/ AdditionalSignatures = completion_signatures<>, template<class...> class SetValue = /* 查看描述 */, template<class> class SetError = /* 查看描述 */, /*有效完成签名*/ SetStopped = completion_signatures<set_stopped_t()>> using transform_completion_signatures = completion_signatures</* 查看描述 */>; template<sender Sndr, class Env = env<>, /*有效完成签名*/ AdditionalSignatures = completion_signatures<>, template<class...> class SetValue = /* 查看描述 */, template<class> class SetError = /* 查看描述 */, /*有效完成签名*/ SetStopped = completion_signatures<set_stopped_t()>> requires sender_in<Sndr, Env> using transform_completion_signatures_of = transform_completion_signatures<completion_signatures_of_t<Sndr, Env>, AdditionalSignatures, SetValue, SetError, SetStopped>; // run_loop class run_loop; } namespace std::this_thread { // 消费者 struct sync_wait_t { /* 未指定 */ }; struct sync_wait_with_variant_t { /* 未指定 */ }; inline constexpr sync_wait_t sync_wait{}; inline constexpr sync_wait_with_variant_t sync_wait_with_variant{}; } namespace std::执行 { struct as_awaitable_t { /* 未指定 */ }; inline constexpr as_awaitable_t as_awaitable{}; template</*类类型*/ Promise> struct with_awaitable_senders; }
辅助概念
namespace std { template<class T> concept /*movable-value*/ = // 仅用于说明 move_constructible<decay_t<T>> && constructible_from<decay_t<T>, T> && (!is_array_v<remove_reference_t<T>>); } namespace std { template<class T> concept /*queryable*/ = destructible<T>; // 仅用于说明 } namespace std::execution { template<class Sndr, class Env> concept /*single-sender*/ = sender_in<Sndr, Env> && requires { typename /*single-sender-value-type*/<Sndr, Env>; }; }
辅助类
namespace std::execution { struct /*empty-variant*/ { // 仅用于说明 /*empty-variant*/() = delete; }; }
enum
std::forward_progress_guarantee
namespace std::execution { enum class forward_progress_guarantee { concurrent, parallel, weakly_parallel }; }
概念
scheduler
namespace std::execution { template<class Sch> concept scheduler = derived_from<typename remove_cvref_t<Sch>::scheduler_concept, scheduler_t> && /*可查询的*/<Sch> && requires(Sch&& sch) { { schedule(std::forward<Sch>(sch)) } -> sender; { auto(get_completion_scheduler<set_value_t>( get_env(schedule(std::forward<Sch>(sch)))) } -> same_as<remove_cvref_t<Sch>>; } && equality_comparable<remove_cvref_t<Sch>> && copy_constructible<remove_cvref_t<Sch>>; }
概念
receiver
namespace std::execution { template<class Rcvr> concept receiver = derived_from<typename remove_cvref_t<Rcvr>::receiver_concept, receiver_t> && requires(const remove_cvref_t<Rcvr>& rcvr) { { get_env(rcvr) } -> /*queryable*/; } && move_constructible<remove_cvref_t<Rcvr>> && // 右值可移动,且 constructible_from<remove_cvref_t<Rcvr>, Rcvr>; // 左值可复制 template<class Signature, class Rcvr> concept /*valid-completion-for*/ = requires(Signature* sig) { []<class Tag, class... Args>(Tag(*)(Args...)) requires /*callable*/<Tag, remove_cvref_t<Rcvr>, Args...> { } (sig); }; template<class Rcvr, class Completions> concept /*has-completions*/ = requires(Completions* completions) { []</*valid-completion-for*/<Rcvr>... Sigs>(completion_signatures<Sigs...>*) { }(completions); }; template<class Rcvr, class Completions> concept receiver_of = receiver<Rcvr> && /*has-completions*/<Rcvr, Completions>; }
概念
operation_state
namespace std::execution { template<class O> concept operation_state = derived_from<typename O::operation_state_concept, operation_state_t> && is_object_v<O> && requires(O& o) { { start(o) } noexcept; }; }