// // execution/inline_exception_handling.hpp // ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ // // Copyright (c) 2003-2025 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 BOOST_ASIO_EXECUTION_INLINE_EXCEPTION_HANDLING_HPP #define BOOST_ASIO_EXECUTION_INLINE_EXCEPTION_HANDLING_HPP #if defined(_MSC_VER) && (_MSC_VER >= 1200) # pragma once #endif // defined(_MSC_VER) && (_MSC_VER >= 1200) #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace boost { namespace asio { #if defined(GENERATING_DOCUMENTATION) namespace execution { /// A property to describe what guarantees an executor makes about the treatment /// of exceptions that are thrown by a submitted function, when that function /// is executed inline within @c execute. struct inline_exception_handling_t { /// The inline_exception_handling property applies to executors. template static constexpr bool is_applicable_property_v = is_executor_v; /// The top-level inline_exception_handling property cannot be required. static constexpr bool is_requirable = false; /// The top-level inline_exception_handling property cannot be preferred. static constexpr bool is_preferable = false; /// The type returned by queries against an @c any_executor. typedef inline_exception_handling_t polymorphic_query_result_type; /// A sub-property that indicates that invocation of an executor's execution /// function will propagate any exceptions that are thrown by the submitted /// function object, if that function object is executed inline. struct propagate_t { /// The inline_exception_handling_t::propagate_t property applies to /// executors. template static constexpr bool is_applicable_property_v = is_executor_v; /// The inline_exception_handling_t::propagate_t property can be required. static constexpr bool is_requirable = true; /// The inline_exception_handling_t::propagate_t property can be preferred. static constexpr bool is_preferable = true; /// The type returned by queries against an @c any_executor. typedef inline_exception_handling_t polymorphic_query_result_type; /// Default constructor. constexpr propagate_t(); /// Get the value associated with a property object. /** * @returns propagate_t(); */ static constexpr inline_exception_handling_t value(); }; /// A sub-property that indicates that invocation of an executor's execution /// function will capture any exceptions that are thrown by the submitted /// function object, if that function object is executed inline. Captured /// exceptions are forwarded to an executor-defined handling mechanism. struct capture_t { /// The inline_exception_handling_t::capture_t property applies to /// executors. template static constexpr bool is_applicable_property_v = is_executor_v; /// The inline_exception_handling_t::capture_t property can be required. static constexpr bool is_requirable = true; /// The inline_exception_handling_t::capture_t property can be preferred. static constexpr bool is_preferable = false; /// The type returned by queries against an @c any_executor. typedef inline_exception_handling_t polymorphic_query_result_type; /// Default constructor. constexpr capture_t(); /// Get the value associated with a property object. /** * @returns capture_t(); */ static constexpr inline_exception_handling_t value(); }; /// A sub-property that indicates that invocation of an executor's execution /// function will terminate the program if any exceptions that are thrown by /// the submitted function object, if that function object is executed inline. struct terminate_t { /// The inline_exception_handling_t::terminate_t property applies to /// executors. template static constexpr bool is_applicable_property_v = is_executor_v; /// The inline_exception_handling_t::terminate_t property can be required. static constexpr bool is_requirable = true; /// The inline_exception_handling_t::terminate_t property can be preferred. static constexpr bool is_preferable = true; /// The type returned by queries against an @c any_executor. typedef inline_exception_handling_t polymorphic_query_result_type; /// Default constructor. constexpr terminate_t(); /// Get the value associated with a property object. /** * @returns terminate_t(); */ static constexpr inline_exception_handling_t value(); }; /// A special value used for accessing the /// inline_exception_handling_t::propagate_t property. static constexpr propagate_t propagate; /// A special value used for accessing the /// inline_exception_handling_t::capture_t property. static constexpr capture_t capture; /// A special value used for accessing the /// inline_exception_handling_t::terminate_t property. static constexpr terminate_t terminate; /// Default constructor. constexpr inline_exception_handling_t(); /// Construct from a sub-property value. constexpr inline_exception_handling_t(propagate_t); /// Construct from a sub-property value. constexpr inline_exception_handling_t(capture_t); /// Construct from a sub-property value. constexpr inline_exception_handling_t(terminate_t); /// Compare property values for equality. friend constexpr bool operator==(const inline_exception_handling_t& a, const inline_exception_handling_t& b) noexcept; /// Compare property values for inequality. friend constexpr bool operator!=(const inline_exception_handling_t& a, const inline_exception_handling_t& b) noexcept; }; /// A special value used for accessing the inline_exception_handling property. constexpr inline_exception_handling_t inline_exception_handling; } // namespace execution #else // defined(GENERATING_DOCUMENTATION) namespace execution { namespace detail { namespace inline_exception_handling { template struct propagate_t; template struct capture_t; template struct terminate_t; } // namespace inline_exception_handling template struct inline_exception_handling_t { #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) template static constexpr bool is_applicable_property_v = is_executor::value; #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) static constexpr bool is_requirable = false; static constexpr bool is_preferable = false; typedef inline_exception_handling_t polymorphic_query_result_type; typedef detail::inline_exception_handling::propagate_t propagate_t; typedef detail::inline_exception_handling::capture_t capture_t; typedef detail::inline_exception_handling::terminate_t terminate_t; constexpr inline_exception_handling_t() : value_(-1) { } constexpr inline_exception_handling_t(propagate_t) : value_(0) { } constexpr inline_exception_handling_t(capture_t) : value_(1) { } constexpr inline_exception_handling_t(terminate_t) : value_(2) { } template struct proxy { #if defined(BOOST_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(BOOST_ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT) typedef T type; #endif // defined(BOOST_ASIO_HAS_DEDUCED_QUERY_MEMBER_TRAIT) }; template struct static_proxy { #if defined(BOOST_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(BOOST_ASIO_HAS_DEDUCED_QUERY_STATIC_CONSTEXPR_MEMBER_TRAIT) typedef T type; #endif // defined(BOOST_ASIO_HAS_DEDUCED_QUERY_STATIC_CONSTEXPR_MEMBER_TRAIT) }; template struct query_member : traits::query_member::type, inline_exception_handling_t> {}; template struct query_static_constexpr_member : traits::query_static_constexpr_member< typename static_proxy::type, inline_exception_handling_t> {}; #if defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(BOOST_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 = inline_exception_handling_t::static_query(); #endif // defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) friend constexpr bool operator==(const inline_exception_handling_t& a, const inline_exception_handling_t& b) { return a.value_ == b.value_; } friend constexpr bool operator!=(const inline_exception_handling_t& a, const inline_exception_handling_t& b) { return a.value_ != b.value_; } struct convertible_from_inline_exception_handling_t { constexpr convertible_from_inline_exception_handling_t( inline_exception_handling_t) {} }; template friend constexpr inline_exception_handling_t query( const Executor& ex, convertible_from_inline_exception_handling_t, enable_if_t< can_query::value >* = 0) #if !defined(__clang__) // Clang crashes if noexcept is used here. #if defined(BOOST_ASIO_MSVC) // Visual C++ wants the type to be qualified. noexcept(is_nothrow_query::propagate_t>::value) #else // defined(BOOST_ASIO_MSVC) noexcept(is_nothrow_query::value) #endif // defined(BOOST_ASIO_MSVC) #endif // !defined(__clang__) { return boost::asio::query(ex, propagate_t()); } template friend constexpr inline_exception_handling_t query( const Executor& ex, convertible_from_inline_exception_handling_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(BOOST_ASIO_MSVC) // Visual C++ wants the type to be qualified. noexcept(is_nothrow_query::capture_t>::value) #else // defined(BOOST_ASIO_MSVC) noexcept(is_nothrow_query::value) #endif // defined(BOOST_ASIO_MSVC) #endif // !defined(__clang__) { return boost::asio::query(ex, capture_t()); } template friend constexpr inline_exception_handling_t query( const Executor& ex, convertible_from_inline_exception_handling_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(BOOST_ASIO_MSVC) // Visual C++ wants the type to be qualified. noexcept(is_nothrow_query::terminate_t>::value) #else // defined(BOOST_ASIO_MSVC) noexcept(is_nothrow_query::value) #endif // defined(BOOST_ASIO_MSVC) #endif // !defined(__clang__) { return boost::asio::query(ex, terminate_t()); } BOOST_ASIO_STATIC_CONSTEXPR_DEFAULT_INIT(propagate_t, propagate); BOOST_ASIO_STATIC_CONSTEXPR_DEFAULT_INIT(capture_t, capture); BOOST_ASIO_STATIC_CONSTEXPR_DEFAULT_INIT(terminate_t, terminate); private: int value_; }; #if defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template template const T inline_exception_handling_t::static_query_v; #endif // defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template const typename inline_exception_handling_t::propagate_t inline_exception_handling_t::propagate; template const typename inline_exception_handling_t::capture_t inline_exception_handling_t::capture; template const typename inline_exception_handling_t::terminate_t inline_exception_handling_t::terminate; namespace inline_exception_handling { template struct propagate_t { #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) template static constexpr bool is_applicable_property_v = is_executor::value; #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) static constexpr bool is_requirable = true; static constexpr bool is_preferable = true; typedef inline_exception_handling_t polymorphic_query_result_type; constexpr propagate_t() { } template struct query_member : traits::query_member< typename inline_exception_handling_t::template proxy::type, propagate_t> {}; template struct query_static_constexpr_member : traits::query_static_constexpr_member< typename inline_exception_handling_t::template static_proxy::type, propagate_t> {}; #if defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(BOOST_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 propagate_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 propagate_t(); } template ())> static constexpr const T static_query_v = propagate_t::static_query(); #endif // defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) // && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) static constexpr inline_exception_handling_t value() { return propagate_t(); } friend constexpr bool operator==( const propagate_t&, const propagate_t&) { return true; } friend constexpr bool operator!=( const propagate_t&, const propagate_t&) { return false; } friend constexpr bool operator==( const propagate_t&, const capture_t&) { return false; } friend constexpr bool operator!=( const propagate_t&, const capture_t&) { return true; } friend constexpr bool operator==( const propagate_t&, const terminate_t&) { return false; } friend constexpr bool operator!=( const propagate_t&, const terminate_t&) { return true; } }; #if defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template template const T propagate_t::static_query_v; #endif // defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template struct capture_t { #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) template static constexpr bool is_applicable_property_v = is_executor::value; #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) static constexpr bool is_requirable = true; static constexpr bool is_preferable = false; typedef inline_exception_handling_t polymorphic_query_result_type; constexpr capture_t() { } template struct query_member : traits::query_member< typename inline_exception_handling_t::template proxy::type, capture_t> {}; template struct query_static_constexpr_member : traits::query_static_constexpr_member< typename inline_exception_handling_t::template static_proxy::type, capture_t> {}; #if defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(BOOST_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 = capture_t::static_query(); #endif // defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) // && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) static constexpr inline_exception_handling_t value() { return capture_t(); } friend constexpr bool operator==( const capture_t&, const capture_t&) { return true; } friend constexpr bool operator!=( const capture_t&, const capture_t&) { return false; } friend constexpr bool operator==( const capture_t&, const propagate_t&) { return false; } friend constexpr bool operator!=( const capture_t&, const propagate_t&) { return true; } friend constexpr bool operator==( const capture_t&, const terminate_t&) { return false; } friend constexpr bool operator!=( const capture_t&, const terminate_t&) { return true; } }; #if defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template template const T capture_t::static_query_v; #endif // defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template struct terminate_t { #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) template static constexpr bool is_applicable_property_v = is_executor::value; #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) static constexpr bool is_requirable = true; static constexpr bool is_preferable = true; typedef inline_exception_handling_t polymorphic_query_result_type; constexpr terminate_t() { } template struct query_member : traits::query_member< typename inline_exception_handling_t::template proxy::type, terminate_t> {}; template struct query_static_constexpr_member : traits::query_static_constexpr_member< typename inline_exception_handling_t::template static_proxy::type, terminate_t> {}; #if defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(BOOST_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 = terminate_t::static_query(); #endif // defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) static constexpr inline_exception_handling_t value() { return terminate_t(); } friend constexpr bool operator==(const terminate_t&, const terminate_t&) { return true; } friend constexpr bool operator!=(const terminate_t&, const terminate_t&) { return false; } friend constexpr bool operator==(const terminate_t&, const propagate_t&) { return false; } friend constexpr bool operator!=(const terminate_t&, const propagate_t&) { return true; } friend constexpr bool operator==(const terminate_t&, const capture_t&) { return false; } friend constexpr bool operator!=(const terminate_t&, const capture_t&) { return true; } }; #if defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ && defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) template template const T terminate_t::static_query_v; #endif // defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) } // namespace inline_exception_handling } // namespace detail typedef detail::inline_exception_handling_t<> inline_exception_handling_t; BOOST_ASIO_INLINE_VARIABLE constexpr inline_exception_handling_t inline_exception_handling; } // namespace execution #if !defined(BOOST_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(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) namespace traits { #if !defined(BOOST_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::inline_exception_handling_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::inline_exception_handling_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::inline_exception_handling_t result_type; }; #endif // !defined(BOOST_ASIO_HAS_DEDUCED_QUERY_FREE_TRAIT) #if !defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) \ || !defined(BOOST_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::inline_exception_handling_t<0>:: query_static_constexpr_member::result_type result_type; static constexpr result_type value() { return execution::inline_exception_handling_t:: query_static_constexpr_member::value(); } }; template struct static_query:: query_static_constexpr_member::is_valid && !execution::detail::inline_exception_handling_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::inline_exception_handling_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::inline_exception_handling_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::inline_exception_handling:: propagate_t<0>::query_static_constexpr_member::result_type result_type; static constexpr result_type value() { return execution::detail::inline_exception_handling::propagate_t<0>:: query_static_constexpr_member::value(); } }; template struct static_query:: query_static_constexpr_member::is_valid && !execution::detail::inline_exception_handling::propagate_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::inline_exception_handling_t::propagate_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::inline_exception_handling:: capture_t<0>::query_static_constexpr_member::result_type result_type; static constexpr result_type value() { return execution::detail::inline_exception_handling::capture_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::inline_exception_handling:: terminate_t<0>::query_static_constexpr_member::result_type result_type; static constexpr result_type value() { return execution::detail::inline_exception_handling::terminate_t<0>:: query_static_constexpr_member::value(); } }; #endif // !defined(BOOST_ASIO_HAS_DEDUCED_STATIC_QUERY_TRAIT) // || !defined(BOOST_ASIO_HAS_SFINAE_VARIABLE_TEMPLATES) } // namespace traits #endif // defined(GENERATING_DOCUMENTATION) } // namespace asio } // namespace boost #include #endif // BOOST_ASIO_EXECUTION_INLINE_EXCEPTION_HANDLING_HPP