// // prefer.hpp // ~~~~~~~~~~ // // Copyright (c) 2003-2022 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_PREFER_HPP #define BOOST_ASIO_PREFER_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 #if defined(GENERATING_DOCUMENTATION) namespace boost { namespace asio { /// A customisation point that attempts to apply a property to an object. /** * The name prefer denotes a customisation point object. The * expression boost::asio::prefer(E, P0, Pn...) for some subexpressions * E and P0, and where Pn... represents N * subexpressions (where N is 0 or more, and with types T = * decay_t and Prop0 = decay_t) is * expression-equivalent to: * * @li If is_applicable_property_v && Prop0::is_preferable is * not a well-formed constant expression with value true, * boost::asio::prefer(E, P0, Pn...) is ill-formed. * * @li Otherwise, E if N == 0 and the expression * Prop0::template static_query_v == Prop0::value() is a * well-formed constant expression with value true. * * @li Otherwise, (E).require(P0) if N == 0 and the expression * (E).require(P0) is a valid expression. * * @li Otherwise, require(E, P0) if N == 0 and the expression * require(E, P0) is a valid expression with overload resolution * performed in a context that does not include the declaration of the * require customization point object. * * @li Otherwise, (E).prefer(P0) if N == 0 and the expression * (E).prefer(P0) is a valid expression. * * @li Otherwise, prefer(E, P0) if N == 0 and the expression * prefer(E, P0) is a valid expression with overload resolution * performed in a context that does not include the declaration of the * prefer customization point object. * * @li Otherwise, E if N == 0. * * @li Otherwise, * boost::asio::prefer(boost::asio::prefer(E, P0), Pn...) * if N > 0 and the expression * boost::asio::prefer(boost::asio::prefer(E, P0), Pn...) * is a valid expression. * * @li Otherwise, boost::asio::prefer(E, P0, Pn...) is ill-formed. */ inline constexpr unspecified prefer = unspecified; /// A type trait that determines whether a @c prefer expression is well-formed. /** * Class template @c can_prefer is a trait that is derived from * @c true_type if the expression boost::asio::prefer(std::declval(), * std::declval()...) is well formed; otherwise @c false_type. */ template struct can_prefer : integral_constant { }; /// A type trait that determines whether a @c prefer expression will not throw. /** * Class template @c is_nothrow_prefer is a trait that is derived from * @c true_type if the expression boost::asio::prefer(std::declval(), * std::declval()...) is @c noexcept; otherwise @c false_type. */ template struct is_nothrow_prefer : integral_constant { }; /// A type trait that determines the result type of a @c prefer expression. /** * Class template @c prefer_result is a trait that determines the result * type of the expression boost::asio::prefer(std::declval(), * std::declval()...). */ template struct prefer_result { /// The result of the @c prefer expression. typedef automatically_determined type; }; } // namespace asio } // namespace boost #else // defined(GENERATING_DOCUMENTATION) namespace boost_asio_prefer_fn { using boost::asio::conditional; using boost::asio::decay; using boost::asio::declval; using boost::asio::enable_if; using boost::asio::is_applicable_property; using boost::asio::traits::prefer_free; using boost::asio::traits::prefer_member; using boost::asio::traits::require_free; using boost::asio::traits::require_member; using boost::asio::traits::static_require; void prefer(); void require(); enum overload_type { identity, call_require_member, call_require_free, call_prefer_member, call_prefer_free, two_props, n_props, ill_formed }; template struct call_traits { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = ill_formed); BOOST_ASIO_STATIC_CONSTEXPR(bool, is_noexcept = false); typedef void result_type; }; template struct call_traits::type, typename decay::type >::value >::type, typename enable_if< decay::type::is_preferable >::type, typename enable_if< static_require::is_valid >::type> { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = identity); BOOST_ASIO_STATIC_CONSTEXPR(bool, is_noexcept = true); #if defined(BOOST_ASIO_HAS_MOVE) typedef BOOST_ASIO_MOVE_ARG(T) result_type; #else // defined(BOOST_ASIO_HAS_MOVE) typedef BOOST_ASIO_MOVE_ARG(typename decay::type) result_type; #endif // defined(BOOST_ASIO_HAS_MOVE) }; template struct call_traits::type, typename decay::type >::value >::type, typename enable_if< decay::type::is_preferable >::type, typename enable_if< !static_require::is_valid >::type, typename enable_if< require_member::type, Property>::is_valid >::type> : require_member::type, Property> { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = call_require_member); }; template struct call_traits::type, typename decay::type >::value >::type, typename enable_if< decay::type::is_preferable >::type, typename enable_if< !static_require::is_valid >::type, typename enable_if< !require_member::type, Property>::is_valid >::type, typename enable_if< require_free::is_valid >::type> : require_free { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = call_require_free); }; template struct call_traits::type, typename decay::type >::value >::type, typename enable_if< decay::type::is_preferable >::type, typename enable_if< !static_require::is_valid >::type, typename enable_if< !require_member::type, Property>::is_valid >::type, typename enable_if< !require_free::is_valid >::type, typename enable_if< prefer_member::type, Property>::is_valid >::type> : prefer_member::type, Property> { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = call_prefer_member); }; template struct call_traits::type, typename decay::type >::value >::type, typename enable_if< decay::type::is_preferable >::type, typename enable_if< !static_require::is_valid >::type, typename enable_if< !require_member::type, Property>::is_valid >::type, typename enable_if< !require_free::is_valid >::type, typename enable_if< !prefer_member::type, Property>::is_valid >::type, typename enable_if< prefer_free::is_valid >::type> : prefer_free { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = call_prefer_free); }; template struct call_traits::type, typename decay::type >::value >::type, typename enable_if< decay::type::is_preferable >::type, typename enable_if< !static_require::is_valid >::type, typename enable_if< !require_member::type, Property>::is_valid >::type, typename enable_if< !require_free::is_valid >::type, typename enable_if< !prefer_member::type, Property>::is_valid >::type, typename enable_if< !prefer_free::is_valid >::type> { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = identity); BOOST_ASIO_STATIC_CONSTEXPR(bool, is_noexcept = true); #if defined(BOOST_ASIO_HAS_MOVE) typedef BOOST_ASIO_MOVE_ARG(T) result_type; #else // defined(BOOST_ASIO_HAS_MOVE) typedef BOOST_ASIO_MOVE_ARG(typename decay::type) result_type; #endif // defined(BOOST_ASIO_HAS_MOVE) }; template struct call_traits::overload != ill_formed >::type, typename enable_if< call_traits< Impl, typename call_traits::result_type, void(P1) >::overload != ill_formed >::type> { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = two_props); BOOST_ASIO_STATIC_CONSTEXPR(bool, is_noexcept = ( call_traits::is_noexcept && call_traits< Impl, typename call_traits::result_type, void(P1) >::is_noexcept )); typedef typename decay< typename call_traits< Impl, typename call_traits::result_type, void(P1) >::result_type >::type result_type; }; template struct call_traits::overload != ill_formed >::type, typename enable_if< call_traits< Impl, typename call_traits::result_type, void(P1, PN BOOST_ASIO_ELLIPSIS) >::overload != ill_formed >::type> { BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = n_props); BOOST_ASIO_STATIC_CONSTEXPR(bool, is_noexcept = ( call_traits::is_noexcept && call_traits< Impl, typename call_traits::result_type, void(P1, PN BOOST_ASIO_ELLIPSIS) >::is_noexcept )); typedef typename decay< typename call_traits< Impl, typename call_traits::result_type, void(P1, PN BOOST_ASIO_ELLIPSIS) >::result_type >::type result_type; }; struct impl { template struct proxy { #if defined(BOOST_ASIO_HAS_DEDUCED_REQUIRE_MEMBER_TRAIT) \ && defined(BOOST_ASIO_HAS_DEDUCED_PREFER_MEMBER_TRAIT) struct type { template auto require(BOOST_ASIO_MOVE_ARG(P) p) noexcept( noexcept( declval::type>().require( BOOST_ASIO_MOVE_CAST(P)(p)) ) ) -> decltype( declval::type>().require( BOOST_ASIO_MOVE_CAST(P)(p)) ); template auto prefer(BOOST_ASIO_MOVE_ARG(P) p) noexcept( noexcept( declval::type>().prefer( BOOST_ASIO_MOVE_CAST(P)(p)) ) ) -> decltype( declval::type>().prefer( BOOST_ASIO_MOVE_CAST(P)(p)) ); }; #else // defined(BOOST_ASIO_HAS_DEDUCED_REQUIRE_MEMBER_TRAIT) // && defined(BOOST_ASIO_HAS_DEDUCED_PREFER_MEMBER_TRAIT) typedef T type; #endif // defined(BOOST_ASIO_HAS_DEDUCED_REQUIRE_MEMBER_TRAIT) // && defined(BOOST_ASIO_HAS_DEDUCED_PREFER_MEMBER_TRAIT) }; template BOOST_ASIO_NODISCARD BOOST_ASIO_CONSTEXPR typename enable_if< call_traits::overload == identity, typename call_traits::result_type >::type operator()( BOOST_ASIO_MOVE_ARG(T) t, BOOST_ASIO_MOVE_ARG(Property)) const BOOST_ASIO_NOEXCEPT_IF(( call_traits::is_noexcept)) { return BOOST_ASIO_MOVE_CAST(T)(t); } template BOOST_ASIO_NODISCARD BOOST_ASIO_CONSTEXPR typename enable_if< call_traits::overload == call_require_member, typename call_traits::result_type >::type operator()( BOOST_ASIO_MOVE_ARG(T) t, BOOST_ASIO_MOVE_ARG(Property) p) const BOOST_ASIO_NOEXCEPT_IF(( call_traits::is_noexcept)) { return BOOST_ASIO_MOVE_CAST(T)(t).require( BOOST_ASIO_MOVE_CAST(Property)(p)); } template BOOST_ASIO_NODISCARD BOOST_ASIO_CONSTEXPR typename enable_if< call_traits::overload == call_require_free, typename call_traits::result_type >::type operator()( BOOST_ASIO_MOVE_ARG(T) t, BOOST_ASIO_MOVE_ARG(Property) p) const BOOST_ASIO_NOEXCEPT_IF(( call_traits::is_noexcept)) { return require( BOOST_ASIO_MOVE_CAST(T)(t), BOOST_ASIO_MOVE_CAST(Property)(p)); } template BOOST_ASIO_NODISCARD BOOST_ASIO_CONSTEXPR typename enable_if< call_traits::overload == call_prefer_member, typename call_traits::result_type >::type operator()( BOOST_ASIO_MOVE_ARG(T) t, BOOST_ASIO_MOVE_ARG(Property) p) const BOOST_ASIO_NOEXCEPT_IF(( call_traits::is_noexcept)) { return BOOST_ASIO_MOVE_CAST(T)(t).prefer( BOOST_ASIO_MOVE_CAST(Property)(p)); } template BOOST_ASIO_NODISCARD BOOST_ASIO_CONSTEXPR typename enable_if< call_traits::overload == call_prefer_free, typename call_traits::result_type >::type operator()( BOOST_ASIO_MOVE_ARG(T) t, BOOST_ASIO_MOVE_ARG(Property) p) const BOOST_ASIO_NOEXCEPT_IF(( call_traits::is_noexcept)) { return prefer( BOOST_ASIO_MOVE_CAST(T)(t), BOOST_ASIO_MOVE_CAST(Property)(p)); } template BOOST_ASIO_NODISCARD BOOST_ASIO_CONSTEXPR typename enable_if< call_traits::overload == two_props, typename call_traits::result_type >::type operator()( BOOST_ASIO_MOVE_ARG(T) t, BOOST_ASIO_MOVE_ARG(P0) p0, BOOST_ASIO_MOVE_ARG(P1) p1) const BOOST_ASIO_NOEXCEPT_IF(( call_traits::is_noexcept)) { return (*this)( (*this)( BOOST_ASIO_MOVE_CAST(T)(t), BOOST_ASIO_MOVE_CAST(P0)(p0)), BOOST_ASIO_MOVE_CAST(P1)(p1)); } template BOOST_ASIO_NODISCARD BOOST_ASIO_CONSTEXPR typename enable_if< call_traits::overload == n_props, typename call_traits::result_type >::type operator()( BOOST_ASIO_MOVE_ARG(T) t, BOOST_ASIO_MOVE_ARG(P0) p0, BOOST_ASIO_MOVE_ARG(P1) p1, BOOST_ASIO_MOVE_ARG(PN) BOOST_ASIO_ELLIPSIS pn) const BOOST_ASIO_NOEXCEPT_IF(( call_traits::is_noexcept)) { return (*this)( (*this)( BOOST_ASIO_MOVE_CAST(T)(t), BOOST_ASIO_MOVE_CAST(P0)(p0)), BOOST_ASIO_MOVE_CAST(P1)(p1), BOOST_ASIO_MOVE_CAST(PN)(pn) BOOST_ASIO_ELLIPSIS); } }; template struct static_instance { static const T instance; }; template const T static_instance::instance = {}; } // namespace boost_asio_prefer_fn namespace boost { namespace asio { namespace { static BOOST_ASIO_CONSTEXPR const boost_asio_prefer_fn::impl& prefer = boost_asio_prefer_fn::static_instance<>::instance; } // namespace typedef boost_asio_prefer_fn::impl prefer_t; #if defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) template struct can_prefer : integral_constant::overload != boost_asio_prefer_fn::ill_formed> { }; #else // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) template struct can_prefer : integral_constant::overload != boost_asio_prefer_fn::ill_formed> { }; template struct can_prefer : integral_constant::overload != boost_asio_prefer_fn::ill_formed> { }; template struct can_prefer : integral_constant::overload != boost_asio_prefer_fn::ill_formed> { }; template struct can_prefer : false_type { }; #endif // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) template constexpr bool can_prefer_v = can_prefer::value; #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) #if defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) template struct is_nothrow_prefer : integral_constant::is_noexcept> { }; #else // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) template struct is_nothrow_prefer : integral_constant::is_noexcept> { }; template struct is_nothrow_prefer : integral_constant::is_noexcept> { }; template struct is_nothrow_prefer : integral_constant::is_noexcept> { }; template struct is_nothrow_prefer : false_type { }; #endif // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) template constexpr bool is_nothrow_prefer_v = is_nothrow_prefer::value; #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES) #if defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) template struct prefer_result { typedef typename boost_asio_prefer_fn::call_traits< prefer_t, T, void(Properties...)>::result_type type; }; #else // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) template struct prefer_result { typedef typename boost_asio_prefer_fn::call_traits< prefer_t, T, void(P0, P1, P2)>::result_type type; }; template struct prefer_result { typedef typename boost_asio_prefer_fn::call_traits< prefer_t, T, void(P0, P1)>::result_type type; }; template struct prefer_result { typedef typename boost_asio_prefer_fn::call_traits< prefer_t, T, void(P0)>::result_type type; }; template struct prefer_result { }; #endif // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) } // namespace asio } // namespace boost #endif // defined(GENERATING_DOCUMENTATION) #include #endif // BOOST_ASIO_PREFER_HPP