receiver.hpp 9.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287
  1. //
  2. // execution/receiver.hpp
  3. // ~~~~~~~~~~~~~~~~~~~~~~
  4. //
  5. // Copyright (c) 2003-2023 Christopher M. Kohlhoff (chris at kohlhoff dot com)
  6. //
  7. // Distributed under the Boost Software License, Version 1.0. (See accompanying
  8. // file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
  9. //
  10. #ifndef BOOST_ASIO_EXECUTION_RECEIVER_HPP
  11. #define BOOST_ASIO_EXECUTION_RECEIVER_HPP
  12. #if defined(_MSC_VER) && (_MSC_VER >= 1200)
  13. # pragma once
  14. #endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
  15. #include <boost/asio/detail/config.hpp>
  16. #if !defined(BOOST_ASIO_NO_DEPRECATED)
  17. #include <boost/asio/detail/type_traits.hpp>
  18. #include <boost/asio/detail/variadic_templates.hpp>
  19. #include <boost/asio/execution/set_done.hpp>
  20. #include <boost/asio/execution/set_error.hpp>
  21. #include <boost/asio/execution/set_value.hpp>
  22. #if defined(BOOST_ASIO_HAS_STD_EXCEPTION_PTR)
  23. # include <exception>
  24. #else // defined(BOOST_ASIO_HAS_STD_EXCEPTION_PTR)
  25. # include <boost/system/error_code.hpp>
  26. #endif // defined(BOOST_ASIO_HAS_STD_EXCEPTION_PTR)
  27. #if defined(BOOST_ASIO_HAS_DEDUCED_SET_DONE_FREE_TRAIT) \
  28. && defined(BOOST_ASIO_HAS_DEDUCED_SET_DONE_MEMBER_TRAIT) \
  29. && defined(BOOST_ASIO_HAS_DEDUCED_SET_ERROR_FREE_TRAIT) \
  30. && defined(BOOST_ASIO_HAS_DEDUCED_SET_ERROR_MEMBER_TRAIT) \
  31. && defined(BOOST_ASIO_HAS_DEDUCED_SET_VALUE_FREE_TRAIT) \
  32. && defined(BOOST_ASIO_HAS_DEDUCED_SET_VALUE_MEMBER_TRAIT) \
  33. && defined(BOOST_ASIO_HAS_DEDUCED_RECEIVER_OF_FREE_TRAIT) \
  34. && defined(BOOST_ASIO_HAS_DEDUCED_RECEIVER_OF_MEMBER_TRAIT)
  35. # define BOOST_ASIO_HAS_DEDUCED_EXECUTION_IS_RECEIVER_TRAIT 1
  36. #endif // defined(BOOST_ASIO_HAS_DEDUCED_SET_DONE_FREE_TRAIT)
  37. // && defined(BOOST_ASIO_HAS_DEDUCED_SET_DONE_MEMBER_TRAIT)
  38. // && defined(BOOST_ASIO_HAS_DEDUCED_SET_ERROR_FREE_TRAIT)
  39. // && defined(BOOST_ASIO_HAS_DEDUCED_SET_ERROR_MEMBER_TRAIT)
  40. // && defined(BOOST_ASIO_HAS_DEDUCED_SET_VALUE_FREE_TRAIT)
  41. // && defined(BOOST_ASIO_HAS_DEDUCED_SET_VALUE_MEMBER_TRAIT)
  42. // && defined(BOOST_ASIO_HAS_DEDUCED_RECEIVER_OF_FREE_TRAIT)
  43. // && defined(BOOST_ASIO_HAS_DEDUCED_RECEIVER_OF_MEMBER_TRAIT)
  44. #include <boost/asio/detail/push_options.hpp>
  45. namespace boost {
  46. namespace asio {
  47. namespace execution {
  48. namespace detail {
  49. template <typename T, typename E>
  50. struct is_receiver_base :
  51. integral_constant<bool,
  52. is_move_constructible<typename remove_cvref<T>::type>::value
  53. && is_constructible<typename remove_cvref<T>::type, T>::value
  54. >
  55. {
  56. };
  57. } // namespace detail
  58. #if defined(BOOST_ASIO_HAS_STD_EXCEPTION_PTR)
  59. # define BOOST_ASIO_EXECUTION_RECEIVER_ERROR_DEFAULT = std::exception_ptr
  60. #else // defined(BOOST_ASIO_HAS_STD_EXCEPTION_PTR)
  61. # define BOOST_ASIO_EXECUTION_RECEIVER_ERROR_DEFAULT \
  62. = ::boost::system::error_code
  63. #endif // defined(BOOST_ASIO_HAS_STD_EXCEPTION_PTR)
  64. /// The is_receiver trait detects whether a type T satisfies the
  65. /// execution::receiver concept.
  66. /**
  67. * Class template @c is_receiver is a type trait that is derived from @c
  68. * true_type if the type @c T meets the concept definition for a receiver for
  69. * error type @c E, otherwise @c false_type.
  70. */
  71. template <typename T, typename E BOOST_ASIO_EXECUTION_RECEIVER_ERROR_DEFAULT>
  72. struct is_receiver :
  73. #if defined(GENERATING_DOCUMENTATION)
  74. integral_constant<bool, automatically_determined>
  75. #else // defined(GENERATING_DOCUMENTATION)
  76. conditional<
  77. can_set_done<typename remove_cvref<T>::type>::value
  78. && is_nothrow_set_done<typename remove_cvref<T>::type>::value
  79. && can_set_error<typename remove_cvref<T>::type, E>::value
  80. && is_nothrow_set_error<typename remove_cvref<T>::type, E>::value,
  81. detail::is_receiver_base<T, E>,
  82. false_type
  83. >::type
  84. #endif // defined(GENERATING_DOCUMENTATION)
  85. {
  86. };
  87. #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
  88. template <typename T, typename E BOOST_ASIO_EXECUTION_RECEIVER_ERROR_DEFAULT>
  89. BOOST_ASIO_CONSTEXPR const bool is_receiver_v = is_receiver<T, E>::value;
  90. #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
  91. #if defined(BOOST_ASIO_HAS_CONCEPTS)
  92. template <typename T, typename E BOOST_ASIO_EXECUTION_RECEIVER_ERROR_DEFAULT>
  93. BOOST_ASIO_CONCEPT receiver = is_receiver<T, E>::value;
  94. #define BOOST_ASIO_EXECUTION_RECEIVER ::boost::asio::execution::receiver
  95. #else // defined(BOOST_ASIO_HAS_CONCEPTS)
  96. #define BOOST_ASIO_EXECUTION_RECEIVER typename
  97. #endif // defined(BOOST_ASIO_HAS_CONCEPTS)
  98. #if defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) \
  99. || defined(GENERATING_DOCUMENTATION)
  100. /// The is_receiver_of trait detects whether a type T satisfies the
  101. /// execution::receiver_of concept for some set of value arguments.
  102. /**
  103. * Class template @c is_receiver_of is a type trait that is derived from @c
  104. * true_type if the type @c T meets the concept definition for a receiver for
  105. * value arguments @c Vs, otherwise @c false_type.
  106. */
  107. template <typename T, typename... Vs>
  108. struct is_receiver_of :
  109. #if defined(GENERATING_DOCUMENTATION)
  110. integral_constant<bool, automatically_determined>
  111. #else // defined(GENERATING_DOCUMENTATION)
  112. conditional<
  113. is_receiver<T>::value,
  114. can_set_value<typename remove_cvref<T>::type, Vs...>,
  115. false_type
  116. >::type
  117. #endif // defined(GENERATING_DOCUMENTATION)
  118. {
  119. };
  120. #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
  121. template <typename T, typename... Vs>
  122. BOOST_ASIO_CONSTEXPR const bool is_receiver_of_v =
  123. is_receiver_of<T, Vs...>::value;
  124. #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
  125. #if defined(BOOST_ASIO_HAS_CONCEPTS)
  126. template <typename T, typename... Vs>
  127. BOOST_ASIO_CONCEPT receiver_of = is_receiver_of<T, Vs...>::value;
  128. #define BOOST_ASIO_EXECUTION_RECEIVER_OF_0 \
  129. ::boost::asio::execution::receiver_of
  130. #define BOOST_ASIO_EXECUTION_RECEIVER_OF_1(v) \
  131. ::boost::asio::execution::receiver_of<v>
  132. #else // defined(BOOST_ASIO_HAS_CONCEPTS)
  133. #define BOOST_ASIO_EXECUTION_RECEIVER_OF_0 typename
  134. #define BOOST_ASIO_EXECUTION_RECEIVER_OF_1(v) typename
  135. #endif // defined(BOOST_ASIO_HAS_CONCEPTS)
  136. #else // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
  137. // || defined(GENERATING_DOCUMENTATION)
  138. template <typename T, typename = void,
  139. typename = void, typename = void, typename = void, typename = void,
  140. typename = void, typename = void, typename = void, typename = void>
  141. struct is_receiver_of;
  142. template <typename T>
  143. struct is_receiver_of<T> :
  144. conditional<
  145. is_receiver<T>::value,
  146. can_set_value<typename remove_cvref<T>::type>,
  147. false_type
  148. >::type
  149. {
  150. };
  151. #define BOOST_ASIO_PRIVATE_RECEIVER_OF_TRAITS_DEF(n) \
  152. template <typename T, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
  153. struct is_receiver_of<T, BOOST_ASIO_VARIADIC_TARGS(n)> : \
  154. conditional< \
  155. conditional<true, is_receiver<T>, void>::type::value, \
  156. can_set_value< \
  157. typename remove_cvref<T>::type, \
  158. BOOST_ASIO_VARIADIC_TARGS(n)>, \
  159. false_type \
  160. >::type \
  161. { \
  162. }; \
  163. /**/
  164. BOOST_ASIO_VARIADIC_GENERATE(BOOST_ASIO_PRIVATE_RECEIVER_OF_TRAITS_DEF)
  165. #undef BOOST_ASIO_PRIVATE_RECEIVER_OF_TRAITS_DEF
  166. #define BOOST_ASIO_EXECUTION_RECEIVER_OF_0 typename
  167. #define BOOST_ASIO_EXECUTION_RECEIVER_OF_1(v) typename
  168. #endif // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
  169. // || defined(GENERATING_DOCUMENTATION)
  170. #if defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES) \
  171. || defined(GENERATING_DOCUMENTATION)
  172. /// The is_nothrow_receiver_of trait detects whether a type T satisfies the
  173. /// execution::receiver_of concept for some set of value arguments, with a
  174. /// noexcept @c set_value operation.
  175. /**
  176. * Class template @c is_nothrow_receiver_of is a type trait that is derived
  177. * from @c true_type if the type @c T meets the concept definition for a
  178. * receiver for value arguments @c Vs, and the expression
  179. * <tt>execution::set_value(declval<T>(), declval<Ts>()...)</tt> is noexcept,
  180. * otherwise @c false_type.
  181. */
  182. template <typename T, typename... Vs>
  183. struct is_nothrow_receiver_of :
  184. #if defined(GENERATING_DOCUMENTATION)
  185. integral_constant<bool, automatically_determined>
  186. #else // defined(GENERATING_DOCUMENTATION)
  187. integral_constant<bool,
  188. is_receiver_of<T, Vs...>::value
  189. && is_nothrow_set_value<typename remove_cvref<T>::type, Vs...>::value
  190. >
  191. #endif // defined(GENERATING_DOCUMENTATION)
  192. {
  193. };
  194. #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
  195. template <typename T, typename... Vs>
  196. BOOST_ASIO_CONSTEXPR const bool is_nothrow_receiver_of_v =
  197. is_nothrow_receiver_of<T, Vs...>::value;
  198. #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
  199. #else // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
  200. // || defined(GENERATING_DOCUMENTATION)
  201. template <typename T, typename = void,
  202. typename = void, typename = void, typename = void, typename = void,
  203. typename = void, typename = void, typename = void, typename = void>
  204. struct is_nothrow_receiver_of;
  205. template <typename T>
  206. struct is_nothrow_receiver_of<T> :
  207. integral_constant<bool,
  208. is_receiver_of<T>::value
  209. && is_nothrow_set_value<typename remove_cvref<T>::type>::value
  210. >
  211. {
  212. };
  213. #define BOOST_ASIO_PRIVATE_NOTHROW_RECEIVER_OF_TRAITS_DEF(n) \
  214. template <typename T, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
  215. struct is_nothrow_receiver_of<T, BOOST_ASIO_VARIADIC_TARGS(n)> : \
  216. integral_constant<bool, \
  217. is_receiver_of<T, BOOST_ASIO_VARIADIC_TARGS(n)>::value \
  218. && is_nothrow_set_value<typename remove_cvref<T>::type, \
  219. BOOST_ASIO_VARIADIC_TARGS(n)>::value \
  220. > \
  221. { \
  222. }; \
  223. /**/
  224. BOOST_ASIO_VARIADIC_GENERATE(BOOST_ASIO_PRIVATE_NOTHROW_RECEIVER_OF_TRAITS_DEF)
  225. #undef BOOST_ASIO_PRIVATE_NOTHROW_RECEIVER_OF_TRAITS_DEF
  226. #endif // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
  227. // || defined(GENERATING_DOCUMENTATION)
  228. } // namespace execution
  229. } // namespace asio
  230. } // namespace boost
  231. #include <boost/asio/detail/pop_options.hpp>
  232. #endif // !defined(BOOST_ASIO_NO_DEPRECATED)
  233. #endif // BOOST_ASIO_EXECUTION_RECEIVER_HPP