// // execution/mapping.hpp // ~~~~~~~~~~~~~~~~~~~~~ // // Copyright (c) 2003-2024 Christopher M. Kohlhoff (chris at kohlhoff dot com) // // Distributed under the Boost Software License, Version 1.0. (See accompanying // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) // #ifndef ASIO_EXECUTION_MAPPING_HPP #define ASIO_EXECUTION_MAPPING_HPP #if defined(_MSC_VER) && (_MSC_VER >= 1200) # pragma once #endif // defined(_MSC_VER) && (_MSC_VER >= 1200) #include "asio/detail/config.hpp" #include "asio/detail/type_traits.hpp" #include "asio/execution/executor.hpp" #include "asio/is_applicable_property.hpp" #include "asio/query.hpp" #include "asio/traits/query_free.hpp" #include "asio/traits/query_member.hpp" #include "asio/traits/query_static_constexpr_member.hpp" #include "asio/traits/static_query.hpp" #include "asio/traits/static_require.hpp" #include "asio/detail/push_options.hpp" namespace asio { #if defined(GENERATING_DOCUMENTATION) namespace execution { /// A property to describe what guarantees an executor makes about the mapping /// of execution agents on to threads of execution. struct mapping_t { /// The mapping_t property applies to executors. template static constexpr bool is_applicable_property_v = is_executor_v; /// The top-level mapping_t property cannot be required. static constexpr bool is_requirable = false; /// The top-level mapping_t property cannot be preferred. static constexpr bool is_preferable = false; /// The type returned by queries against an @c any_executor. typedef mapping_t polymorphic_query_result_type; /// A sub-property that indicates that execution agents are mapped on to /// threads of execution. struct thread_t { /// The mapping_t::thread_t property applies to executors. template static constexpr bool is_applicable_property_v = is_executor_v; /// The mapping_t::thread_t property can be required. static constexpr bool is_requirable = true; /// The mapping_t::thread_t property can be preferred. static constexpr bool is_preferable = true; /// The type returned by queries against an @c any_executor. typedef mapping_t polymorphic_query_result_type; /// Default constructor. constexpr thread_t(); /// Get the value associated with a property object. /** * @returns thread_t(); */ static constexpr mapping_t value(); }; /// A sub-property that indicates that execution agents are mapped on to /// new threads of execution. struct new_thread_t { /// The mapping_t::new_thread_t property applies to executors. template static constexpr bool is_applicable_property_v = is_executor_v; /// The mapping_t::new_thread_t property can be required. static constexpr bool is_requirable = true; /// The mapping_t::new_thread_t property can be preferred. static constexpr bool is_preferable = true; /// The type returned by queries against an @c any_executor. typedef mapping_t polymorphic_query_result_type; /// Default constructor. constexpr new_thread_t(); /// Get the value associated with a property object. /** * @returns new_thread_t(); */ static constexpr mapping_t value(); }; /// A sub-property that indicates that the mapping of execution agents is /// implementation-defined. struct other_t { /// The mapping_t::other_t property applies to executors. template static constexpr bool is_applicable_property_v = is_executor_v; /// The mapping_t::other_t property can be required. static constexpr bool is_requirable = true; /// The mapping_t::other_t property can be preferred. static constexpr bool is_preferable = true; /// The type returned by queries against an @c any_executor. typedef mapping_t polymorphic_query_result_type; /// Default constructor. constexpr other_t(); /// Get the value associated with a property object. /** * @returns other_t(); */ static constexpr mapping_t value(); }; /// A special value used for accessing the mapping_t::thread_t property. static constexpr thread_t thread; /// A special value used for accessing the mapping_t::new_thread_t property. static constexpr new_thread_t new_thread; /// A special value used for accessing the mapping_t::other_t property. static constexpr other_t other; /// Default constructor. constexpr mapping_t(); /// Construct from a sub-property value. constexpr mapping_t(thread_t); /// Construct from a sub-property value. constexpr mapping_t(new_thread_t); /// Construct from a sub-property value. constexpr mapping_t(other_t); /// Compare property values for equality. friend constexpr bool operator==( const mapping_t& a, const mapping_t& b) noexcept; /// Compare property values for inequality. friend constexpr bool operator!=( const mapping_t& a, const mapping_t& b) noexcept; }; /// A special value used for accessing the mapping_t property. constexpr mapping_t mapping; } // namespace execution #else // defined(GENERATING_DOCUMENTATION) namespace execution { namespace detail { namespace mapping { template struct thread_t; template struct new_thread_t; template struct other_t; } // namespace mapping template struct mapping_t { #if defined(ASIO_HAS_VARIABLE_TEMPLATES) template static constexpr bool is_applicable_property_v = is_executor::value; #endif // defined(ASIO_HAS_VARIABLE_TEMPLATES) static constexpr bool is_requirable = false; static constexpr bool is_preferable = false; typedef mapping_t polymorphic_query_result_type; typedef detail::mapping::thread_t thread_t; typedef detail::mapping::new_thread_t new_thread_t; typedef detail::mapping::other_t other_t; constexpr mapping_t() : value_(-1) { } constexpr mapping_t(thread_t) : value_(0) { } constexpr mapping_t(new_thread_t) : value_(1) { } constexpr mapping_t(other_t) : value_(2) { } template struct proxy { #if defined(ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT) struct type { template auto query(P&& p) const noexcept( noexcept( declval>().query(static_cast(p)) ) ) -> decltype( declval>().query(static_cast(p)) ); }; #else // defined(ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT) typedef T type; #endif // defined(ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT) }; template struct static_proxy { #if defined(ASIO_HAS_DEDUCED_QUERY_STATIC_CONSTEXPR_MEMBER_TRAIT) struct type { template static constexpr auto query(P&& p) noexcept( noexcept( conditional_t::query(static_cast(p)) ) ) -> decltype( conditional_t::query(static_cast(p)) ) { return T::query(static_cast(p)); } }; #else // defined(ASIO_HAS_DEDUCED_QUERY_STATIC_CONSTEXPR_MEMBER_TRAIT) typedef T type; #endif // defined(ASIO_HAS_DEDUCED_QUERY_STATIC_CONSTEXPR_MEMBER_TRAIT) }; template struct query_member : traits::query_member::type, mapping_t> {}; template struct query_static_constexpr_member : traits::query_static_constexpr_member< typename static_proxy::type, mapping_t> {}; #if defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template static constexpr typename query_static_constexpr_member::result_type static_query() noexcept(query_static_constexpr_member::is_noexcept) { return query_static_constexpr_member::value(); } template static constexpr typename traits::static_query::result_type static_query( enable_if_t< !query_static_constexpr_member::is_valid >* = 0, enable_if_t< !query_member::is_valid >* = 0, enable_if_t< traits::static_query::is_valid >* = 0) noexcept { return traits::static_query::value(); } template static constexpr typename traits::static_query::result_type static_query( enable_if_t< !query_static_constexpr_member::is_valid >* = 0, enable_if_t< !query_member::is_valid >* = 0, enable_if_t< !traits::static_query::is_valid >* = 0, enable_if_t< traits::static_query::is_valid >* = 0) noexcept { return traits::static_query::value(); } template static constexpr typename traits::static_query::result_type static_query( enable_if_t< !query_static_constexpr_member::is_valid >* = 0, enable_if_t< !query_member::is_valid >* = 0, enable_if_t< !traits::static_query::is_valid >* = 0, enable_if_t< !traits::static_query::is_valid >* = 0, enable_if_t< traits::static_query::is_valid >* = 0) noexcept { return traits::static_query::value(); } template ())> static constexpr const T static_query_v = mapping_t::static_query(); #endif // defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) friend constexpr bool operator==( const mapping_t& a, const mapping_t& b) { return a.value_ == b.value_; } friend constexpr bool operator!=( const mapping_t& a, const mapping_t& b) { return a.value_ != b.value_; } struct convertible_from_mapping_t { constexpr convertible_from_mapping_t(mapping_t) {} }; template friend constexpr mapping_t query( const Executor& ex, convertible_from_mapping_t, enable_if_t< can_query::value >* = 0) #if !defined(__clang__) // Clang crashes if noexcept is used here. #if defined(ASIO_MSVC) // Visual C++ wants the type to be qualified. noexcept(is_nothrow_query::thread_t>::value) #else // defined(ASIO_MSVC) noexcept(is_nothrow_query::value) #endif // defined(ASIO_MSVC) #endif // !defined(__clang__) { return asio::query(ex, thread_t()); } template friend constexpr mapping_t query( const Executor& ex, convertible_from_mapping_t, enable_if_t< !can_query::value >* = 0, enable_if_t< can_query::value >* = 0) #if !defined(__clang__) // Clang crashes if noexcept is used here. #if defined(ASIO_MSVC) // Visual C++ wants the type to be qualified. noexcept( is_nothrow_query::new_thread_t>::value) #else // defined(ASIO_MSVC) noexcept(is_nothrow_query::value) #endif // defined(ASIO_MSVC) #endif // !defined(__clang__) { return asio::query(ex, new_thread_t()); } template friend constexpr mapping_t query( const Executor& ex, convertible_from_mapping_t, enable_if_t< !can_query::value >* = 0, enable_if_t< !can_query::value >* = 0, enable_if_t< can_query::value >* = 0) #if !defined(__clang__) // Clang crashes if noexcept is used here. #if defined(ASIO_MSVC) // Visual C++ wants the type to be qualified. noexcept(is_nothrow_query::other_t>::value) #else // defined(ASIO_MSVC) noexcept(is_nothrow_query::value) #endif // defined(ASIO_MSVC) #endif // !defined(__clang__) { return asio::query(ex, other_t()); } ASIO_STATIC_CONSTEXPR_DEFAULT_INIT(thread_t, thread); ASIO_STATIC_CONSTEXPR_DEFAULT_INIT(new_thread_t, new_thread); ASIO_STATIC_CONSTEXPR_DEFAULT_INIT(other_t, other); private: int value_; }; #if defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template template const T mapping_t::static_query_v; #endif // defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template const typename mapping_t::thread_t mapping_t::thread; template const typename mapping_t::new_thread_t mapping_t::new_thread; template const typename mapping_t::other_t mapping_t::other; namespace mapping { template struct thread_t { #if defined(ASIO_HAS_VARIABLE_TEMPLATES) template static constexpr bool is_applicable_property_v = is_executor::value; #endif // defined(ASIO_HAS_VARIABLE_TEMPLATES) static constexpr bool is_requirable = true; static constexpr bool is_preferable = true; typedef mapping_t polymorphic_query_result_type; constexpr thread_t() { } template struct query_member : traits::query_member< typename mapping_t::template proxy::type, thread_t> {}; template struct query_static_constexpr_member : traits::query_static_constexpr_member< typename mapping_t::template static_proxy::type, thread_t> {}; #if defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template static constexpr typename query_static_constexpr_member::result_type static_query() noexcept(query_static_constexpr_member::is_noexcept) { return query_static_constexpr_member::value(); } template static constexpr thread_t static_query( enable_if_t< !query_static_constexpr_member::is_valid >* = 0, enable_if_t< !query_member::is_valid >* = 0, enable_if_t< !traits::query_free::is_valid >* = 0, enable_if_t< !can_query>::value >* = 0, enable_if_t< !can_query>::value >* = 0) noexcept { return thread_t(); } template ())> static constexpr const T static_query_v = thread_t::static_query(); #endif // defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) static constexpr mapping_t value() { return thread_t(); } friend constexpr bool operator==(const thread_t&, const thread_t&) { return true; } friend constexpr bool operator!=(const thread_t&, const thread_t&) { return false; } friend constexpr bool operator==(const thread_t&, const new_thread_t&) { return false; } friend constexpr bool operator!=(const thread_t&, const new_thread_t&) { return true; } friend constexpr bool operator==(const thread_t&, const other_t&) { return false; } friend constexpr bool operator!=(const thread_t&, const other_t&) { return true; } }; #if defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template template const T thread_t::static_query_v; #endif // defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template struct new_thread_t { #if defined(ASIO_HAS_VARIABLE_TEMPLATES) template static constexpr bool is_applicable_property_v = is_executor::value; #endif // defined(ASIO_HAS_VARIABLE_TEMPLATES) static constexpr bool is_requirable = true; static constexpr bool is_preferable = true; typedef mapping_t polymorphic_query_result_type; constexpr new_thread_t() { } template struct query_member : traits::query_member< typename mapping_t::template proxy::type, new_thread_t> {}; template struct query_static_constexpr_member : traits::query_static_constexpr_member< typename mapping_t::template static_proxy::type, new_thread_t> {}; #if defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template static constexpr typename query_static_constexpr_member::result_type static_query() noexcept(query_static_constexpr_member::is_noexcept) { return query_static_constexpr_member::value(); } template ())> static constexpr const T static_query_v = new_thread_t::static_query(); #endif // defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) static constexpr mapping_t value() { return new_thread_t(); } friend constexpr bool operator==(const new_thread_t&, const new_thread_t&) { return true; } friend constexpr bool operator!=(const new_thread_t&, const new_thread_t&) { return false; } friend constexpr bool operator==(const new_thread_t&, const thread_t&) { return false; } friend constexpr bool operator!=(const new_thread_t&, const thread_t&) { return true; } friend constexpr bool operator==(const new_thread_t&, const other_t&) { return false; } friend constexpr bool operator!=(const new_thread_t&, const other_t&) { return true; } }; #if defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template template const T new_thread_t::static_query_v; #endif // defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template struct other_t { #if defined(ASIO_HAS_VARIABLE_TEMPLATES) template static constexpr bool is_applicable_property_v = is_executor::value; #endif // defined(ASIO_HAS_VARIABLE_TEMPLATES) static constexpr bool is_requirable = true; static constexpr bool is_preferable = true; typedef mapping_t polymorphic_query_result_type; constexpr other_t() { } template struct query_member : traits::query_member< typename mapping_t::template proxy::type, other_t> {}; template struct query_static_constexpr_member : traits::query_static_constexpr_member< typename mapping_t::template static_proxy::type, other_t> {}; #if defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template static constexpr typename query_static_constexpr_member::result_type static_query() noexcept(query_static_constexpr_member::is_noexcept) { return query_static_constexpr_member::value(); } template ())> static constexpr const T static_query_v = other_t::static_query(); #endif // defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) static constexpr mapping_t value() { return other_t(); } friend constexpr bool operator==(const other_t&, const other_t&) { return true; } friend constexpr bool operator!=(const other_t&, const other_t&) { return false; } friend constexpr bool operator==(const other_t&, const thread_t&) { return false; } friend constexpr bool operator!=(const other_t&, const thread_t&) { return true; } friend constexpr bool operator==(const other_t&, const new_thread_t&) { return false; } friend constexpr bool operator!=(const other_t&, const new_thread_t&) { return true; } }; #if defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template template const T other_t::static_query_v; #endif // defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) } // namespace mapping } // namespace detail typedef detail::mapping_t<> mapping_t; constexpr mapping_t mapping; } // namespace execution #if !defined(ASIO_HAS_VARIABLE_TEMPLATES) template struct is_applicable_property : integral_constant::value> { }; template struct is_applicable_property : integral_constant::value> { }; template struct is_applicable_property : integral_constant::value> { }; template struct is_applicable_property : integral_constant::value> { }; #endif // !defined(ASIO_HAS_VARIABLE_TEMPLATES) namespace traits { #if !defined(ASIO_HAS_DEDUCED_QUERY_FREE_TRAIT) template struct query_free_default::value >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = is_nothrow_query::value; typedef execution::mapping_t result_type; }; template struct query_free_default::value && can_query::value >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = is_nothrow_query::value; typedef execution::mapping_t result_type; }; template struct query_free_default::value && !can_query::value && can_query::value >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = is_nothrow_query::value; typedef execution::mapping_t result_type; }; #endif // !defined(ASIO_HAS_DEDUCED_QUERY_FREE_TRAIT) #if !defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ || !defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template struct static_query:: query_static_constexpr_member::is_valid >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = true; typedef typename execution::detail::mapping_t<0>:: query_static_constexpr_member::result_type result_type; static constexpr result_type value() { return execution::detail::mapping_t<0>:: query_static_constexpr_member::value(); } }; template struct static_query:: query_static_constexpr_member::is_valid && !execution::detail::mapping_t<0>:: query_member::is_valid && traits::static_query::is_valid >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = true; typedef typename traits::static_query::result_type result_type; static constexpr result_type value() { return traits::static_query::value(); } }; template struct static_query:: query_static_constexpr_member::is_valid && !execution::detail::mapping_t<0>:: query_member::is_valid && !traits::static_query::is_valid && traits::static_query::is_valid >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = true; typedef typename traits::static_query::result_type result_type; static constexpr result_type value() { return traits::static_query::value(); } }; template struct static_query:: query_static_constexpr_member::is_valid && !execution::detail::mapping_t<0>:: query_member::is_valid && !traits::static_query::is_valid && !traits::static_query::is_valid && traits::static_query::is_valid >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = true; typedef typename traits::static_query::result_type result_type; static constexpr result_type value() { return traits::static_query::value(); } }; template struct static_query:: query_static_constexpr_member::is_valid >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = true; typedef typename execution::detail::mapping::thread_t<0>:: query_static_constexpr_member::result_type result_type; static constexpr result_type value() { return execution::detail::mapping::thread_t<0>:: query_static_constexpr_member::value(); } }; template struct static_query:: query_static_constexpr_member::is_valid && !execution::detail::mapping::thread_t<0>:: query_member::is_valid && !traits::query_free::is_valid && !can_query::value && !can_query::value >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = true; typedef execution::mapping_t::thread_t result_type; static constexpr result_type value() { return result_type(); } }; template struct static_query:: query_static_constexpr_member::is_valid >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = true; typedef typename execution::detail::mapping::new_thread_t<0>:: query_static_constexpr_member::result_type result_type; static constexpr result_type value() { return execution::detail::mapping::new_thread_t<0>:: query_static_constexpr_member::value(); } }; template struct static_query:: query_static_constexpr_member::is_valid >> { static constexpr bool is_valid = true; static constexpr bool is_noexcept = true; typedef typename execution::detail::mapping::other_t<0>:: query_static_constexpr_member::result_type result_type; static constexpr result_type value() { return execution::detail::mapping::other_t<0>:: query_static_constexpr_member::value(); } }; #endif // !defined(ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // || !defined(ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) } // namespace traits #endif // defined(GENERATING_DOCUMENTATION) } // namespace asio #include "asio/detail/pop_options.hpp" #endif // ASIO_EXECUTION_MAPPING_HPP