2 // execution/set_value.hpp
3 // ~~~~~~~~~~~~~~~~~~~~~~~
5 // Copyright (c) 2003-2022 Christopher M. Kohlhoff (chris at kohlhoff dot com)
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)
11 #ifndef BOOST_ASIO_EXECUTION_SET_VALUE_HPP
12 #define BOOST_ASIO_EXECUTION_SET_VALUE_HPP
14 #if defined(_MSC_VER) && (_MSC_VER >= 1200)
16 #endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
18 #include <boost/asio/detail/config.hpp>
19 #include <boost/asio/detail/type_traits.hpp>
20 #include <boost/asio/detail/variadic_templates.hpp>
21 #include <boost/asio/traits/set_value_member.hpp>
22 #include <boost/asio/traits/set_value_free.hpp>
24 #include <boost/asio/detail/push_options.hpp>
26 #if defined(GENERATING_DOCUMENTATION)
32 /// A customisation point that delivers a value to a receiver.
34 * The name <tt>execution::set_value</tt> denotes a customisation point object.
35 * The expression <tt>execution::set_value(R, Vs...)</tt> for some
36 * subexpressions <tt>R</tt> and <tt>Vs...</tt> is expression-equivalent to:
38 * @li <tt>R.set_value(Vs...)</tt>, if that expression is valid. If the
39 * function selected does not send the value(s) <tt>Vs...</tt> to the receiver
40 * <tt>R</tt>'s value channel, the program is ill-formed with no diagnostic
43 * @li Otherwise, <tt>set_value(R, Vs...)</tt>, if that expression is valid,
44 * with overload resolution performed in a context that includes the
45 * declaration <tt>void set_value();</tt> and that does not include a
46 * declaration of <tt>execution::set_value</tt>. If the function selected by
47 * overload resolution does not send the value(s) <tt>Vs...</tt> to the
48 * receiver <tt>R</tt>'s value channel, the program is ill-formed with no
49 * diagnostic required.
51 * @li Otherwise, <tt>execution::set_value(R, Vs...)</tt> is ill-formed.
53 inline constexpr unspecified set_value = unspecified;
55 /// A type trait that determines whether a @c set_value expression is
58 * Class template @c can_set_value is a trait that is derived from
59 * @c true_type if the expression <tt>execution::set_value(std::declval<R>(),
60 * std::declval<Vs>()...)</tt> is well formed; otherwise @c false_type.
62 template <typename R, typename... Vs>
63 struct can_set_value :
64 integral_constant<bool, automatically_determined>
68 } // namespace execution
72 #else // defined(GENERATING_DOCUMENTATION)
74 namespace boost_asio_execution_set_value_fn {
76 using boost::asio::decay;
77 using boost::asio::declval;
78 using boost::asio::enable_if;
79 using boost::asio::traits::set_value_free;
80 using boost::asio::traits::set_value_member;
91 template <typename R, typename Vs, typename = void, typename = void>
94 BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = ill_formed);
95 BOOST_ASIO_STATIC_CONSTEXPR(bool, is_noexcept = false);
96 typedef void result_type;
99 template <typename R, typename Vs>
100 struct call_traits<R, Vs,
102 set_value_member<R, Vs>::is_valid
104 set_value_member<R, Vs>
106 BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = call_member);
109 template <typename R, typename Vs>
110 struct call_traits<R, Vs,
112 !set_value_member<R, Vs>::is_valid
115 set_value_free<R, Vs>::is_valid
117 set_value_free<R, Vs>
119 BOOST_ASIO_STATIC_CONSTEXPR(overload_type, overload = call_free);
124 #if defined(BOOST_ASIO_HAS_MOVE)
126 #if defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
128 template <typename R, typename... Vs>
129 BOOST_ASIO_CONSTEXPR typename enable_if<
130 call_traits<R, void(Vs...)>::overload == call_member,
131 typename call_traits<R, void(Vs...)>::result_type
133 operator()(R&& r, Vs&&... v) const
134 BOOST_ASIO_NOEXCEPT_IF((
135 call_traits<R, void(Vs...)>::is_noexcept))
137 return BOOST_ASIO_MOVE_CAST(R)(r).set_value(BOOST_ASIO_MOVE_CAST(Vs)(v)...);
140 template <typename R, typename... Vs>
141 BOOST_ASIO_CONSTEXPR typename enable_if<
142 call_traits<R, void(Vs...)>::overload == call_free,
143 typename call_traits<R, void(Vs...)>::result_type
145 operator()(R&& r, Vs&&... v) const
146 BOOST_ASIO_NOEXCEPT_IF((
147 call_traits<R, void(Vs...)>::is_noexcept))
149 return set_value(BOOST_ASIO_MOVE_CAST(R)(r),
150 BOOST_ASIO_MOVE_CAST(Vs)(v)...);
153 #else // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
155 template <typename R>
156 BOOST_ASIO_CONSTEXPR typename enable_if<
157 call_traits<R, void()>::overload == call_member,
158 typename call_traits<R, void()>::result_type
160 operator()(R&& r) const
161 BOOST_ASIO_NOEXCEPT_IF((
162 call_traits<R, void()>::is_noexcept))
164 return BOOST_ASIO_MOVE_CAST(R)(r).set_value();
167 template <typename R>
168 BOOST_ASIO_CONSTEXPR typename enable_if<
169 call_traits<R, void()>::overload == call_free,
170 typename call_traits<R, void()>::result_type
172 operator()(R&& r) const
173 BOOST_ASIO_NOEXCEPT_IF((
174 call_traits<R, void()>::is_noexcept))
176 return set_value(BOOST_ASIO_MOVE_CAST(R)(r));
179 #define BOOST_ASIO_PRIVATE_SET_VALUE_CALL_DEF(n) \
180 template <typename R, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
181 BOOST_ASIO_CONSTEXPR typename enable_if< \
183 void(BOOST_ASIO_VARIADIC_TARGS(n))>::overload == call_member, \
184 typename call_traits<R, void(BOOST_ASIO_VARIADIC_TARGS(n))>::result_type \
186 operator()(R&& r, BOOST_ASIO_VARIADIC_MOVE_PARAMS(n)) const \
187 BOOST_ASIO_NOEXCEPT_IF(( \
188 call_traits<R, void(BOOST_ASIO_VARIADIC_TARGS(n))>::is_noexcept)) \
190 return BOOST_ASIO_MOVE_CAST(R)(r).set_value( \
191 BOOST_ASIO_VARIADIC_MOVE_ARGS(n)); \
194 template <typename R, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
195 BOOST_ASIO_CONSTEXPR typename enable_if< \
196 call_traits<R, void(BOOST_ASIO_VARIADIC_TARGS(n))>::overload == call_free, \
197 typename call_traits<R, void(BOOST_ASIO_VARIADIC_TARGS(n))>::result_type \
199 operator()(R&& r, BOOST_ASIO_VARIADIC_MOVE_PARAMS(n)) const \
200 BOOST_ASIO_NOEXCEPT_IF(( \
201 call_traits<R, void(BOOST_ASIO_VARIADIC_TARGS(n))>::is_noexcept)) \
203 return set_value(BOOST_ASIO_MOVE_CAST(R)(r), \
204 BOOST_ASIO_VARIADIC_MOVE_ARGS(n)); \
207 BOOST_ASIO_VARIADIC_GENERATE(BOOST_ASIO_PRIVATE_SET_VALUE_CALL_DEF)
208 #undef BOOST_ASIO_PRIVATE_SET_VALUE_CALL_DEF
210 #endif // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
212 #else // defined(BOOST_ASIO_HAS_MOVE)
214 #if defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
216 template <typename R, typename... Vs>
217 BOOST_ASIO_CONSTEXPR typename enable_if<
218 call_traits<R&, void(const Vs&...)>::overload == call_member,
219 typename call_traits<R&, void(const Vs&...)>::result_type
221 operator()(R& r, const Vs&... v) const
222 BOOST_ASIO_NOEXCEPT_IF((
223 call_traits<R&, void(const Vs&...)>::is_noexcept))
225 return r.set_value(v...);
228 template <typename R, typename... Vs>
229 BOOST_ASIO_CONSTEXPR typename enable_if<
230 call_traits<const R&, void(const Vs&...)>::overload == call_member,
231 typename call_traits<const R&, void(const Vs&...)>::result_type
233 operator()(const R& r, const Vs&... v) const
234 BOOST_ASIO_NOEXCEPT_IF((
235 call_traits<const R&, void(const Vs&...)>::is_noexcept))
237 return r.set_value(v...);
240 template <typename R, typename... Vs>
241 BOOST_ASIO_CONSTEXPR typename enable_if<
242 call_traits<R&, void(const Vs&...)>::overload == call_free,
243 typename call_traits<R&, void(const Vs&...)>::result_type
245 operator()(R& r, const Vs&... v) const
246 BOOST_ASIO_NOEXCEPT_IF((
247 call_traits<R&, void(const Vs&...)>::is_noexcept))
249 return set_value(r, v...);
252 template <typename R, typename... Vs>
253 BOOST_ASIO_CONSTEXPR typename enable_if<
254 call_traits<const R&, void(const Vs&...)>::overload == call_free,
255 typename call_traits<const R&, void(const Vs&...)>::result_type
257 operator()(const R& r, const Vs&... v) const
258 BOOST_ASIO_NOEXCEPT_IF((
259 call_traits<const R&, void(const Vs&...)>::is_noexcept))
261 return set_value(r, v...);
264 #else // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
266 template <typename R>
267 BOOST_ASIO_CONSTEXPR typename enable_if<
268 call_traits<R&, void()>::overload == call_member,
269 typename call_traits<R&, void()>::result_type
271 operator()(R& r) const
272 BOOST_ASIO_NOEXCEPT_IF((
273 call_traits<R&, void()>::is_noexcept))
275 return r.set_value();
278 template <typename R>
279 BOOST_ASIO_CONSTEXPR typename enable_if<
280 call_traits<const R&, void()>::overload == call_member,
281 typename call_traits<const R&, void()>::result_type
283 operator()(const R& r) const
284 BOOST_ASIO_NOEXCEPT_IF((
285 call_traits<const R&, void()>::is_noexcept))
287 return r.set_value();
290 template <typename R>
291 BOOST_ASIO_CONSTEXPR typename enable_if<
292 call_traits<R&, void()>::overload == call_free,
293 typename call_traits<R&, void()>::result_type
295 operator()(R& r) const
296 BOOST_ASIO_NOEXCEPT_IF((
297 call_traits<R&, void()>::is_noexcept))
302 template <typename R>
303 BOOST_ASIO_CONSTEXPR typename enable_if<
304 call_traits<const R&, void()>::overload == call_free,
305 typename call_traits<const R&, void()>::result_type
307 operator()(const R& r) const
308 BOOST_ASIO_NOEXCEPT_IF((
309 call_traits<const R&, void()>::is_noexcept))
314 #define BOOST_ASIO_PRIVATE_SET_VALUE_CALL_DEF(n) \
315 template <typename R, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
316 BOOST_ASIO_CONSTEXPR typename enable_if< \
318 void(BOOST_ASIO_VARIADIC_TARGS(n))>::overload == call_member, \
319 typename call_traits<R&, void(BOOST_ASIO_VARIADIC_TARGS(n))>::result_type \
321 operator()(R& r, BOOST_ASIO_VARIADIC_MOVE_PARAMS(n)) const \
322 BOOST_ASIO_NOEXCEPT_IF(( \
323 call_traits<R&, void(BOOST_ASIO_VARIADIC_TARGS(n))>::is_noexcept)) \
325 return r.set_value(BOOST_ASIO_VARIADIC_MOVE_ARGS(n)); \
328 template <typename R, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
329 BOOST_ASIO_CONSTEXPR typename enable_if< \
330 call_traits<const R&, \
331 void(BOOST_ASIO_VARIADIC_TARGS(n))>::overload == call_member, \
332 typename call_traits<const R&, \
333 void(BOOST_ASIO_VARIADIC_TARGS(n))>::result_type \
335 operator()(const R& r, BOOST_ASIO_VARIADIC_MOVE_PARAMS(n)) const \
336 BOOST_ASIO_NOEXCEPT_IF(( \
337 call_traits<const R&, void(BOOST_ASIO_VARIADIC_TARGS(n))>::is_noexcept)) \
339 return r.set_value(BOOST_ASIO_VARIADIC_MOVE_ARGS(n)); \
342 template <typename R, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
343 BOOST_ASIO_CONSTEXPR typename enable_if< \
345 void(BOOST_ASIO_VARIADIC_TARGS(n))>::overload == call_free, \
346 typename call_traits<R&, void(BOOST_ASIO_VARIADIC_TARGS(n))>::result_type \
348 operator()(R& r, BOOST_ASIO_VARIADIC_MOVE_PARAMS(n)) const \
349 BOOST_ASIO_NOEXCEPT_IF(( \
350 call_traits<R&, void(BOOST_ASIO_VARIADIC_TARGS(n))>::is_noexcept)) \
352 return set_value(r, BOOST_ASIO_VARIADIC_MOVE_ARGS(n)); \
355 template <typename R, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
356 BOOST_ASIO_CONSTEXPR typename enable_if< \
357 call_traits<const R&, \
358 void(BOOST_ASIO_VARIADIC_TARGS(n))>::overload == call_free, \
359 typename call_traits<const R&, \
360 void(BOOST_ASIO_VARIADIC_TARGS(n))>::result_type \
362 operator()(const R& r, BOOST_ASIO_VARIADIC_MOVE_PARAMS(n)) const \
363 BOOST_ASIO_NOEXCEPT_IF(( \
364 call_traits<const R&, void(BOOST_ASIO_VARIADIC_TARGS(n))>::is_noexcept)) \
366 return set_value(r, BOOST_ASIO_VARIADIC_MOVE_ARGS(n)); \
369 BOOST_ASIO_VARIADIC_GENERATE(BOOST_ASIO_PRIVATE_SET_VALUE_CALL_DEF)
370 #undef BOOST_ASIO_PRIVATE_SET_VALUE_CALL_DEF
372 #endif // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
374 #endif // defined(BOOST_ASIO_HAS_MOVE)
377 template <typename T = impl>
378 struct static_instance
380 static const T instance;
383 template <typename T>
384 const T static_instance<T>::instance = {};
386 } // namespace boost_asio_execution_set_value_fn
389 namespace execution {
392 static BOOST_ASIO_CONSTEXPR const boost_asio_execution_set_value_fn::impl&
393 set_value = boost_asio_execution_set_value_fn::static_instance<>::instance;
397 #if defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
399 template <typename R, typename... Vs>
400 struct can_set_value :
401 integral_constant<bool,
402 boost_asio_execution_set_value_fn::call_traits<R, void(Vs...)>::overload !=
403 boost_asio_execution_set_value_fn::ill_formed>
407 #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
409 template <typename R, typename... Vs>
410 constexpr bool can_set_value_v = can_set_value<R, Vs...>::value;
412 #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
414 template <typename R, typename... Vs>
415 struct is_nothrow_set_value :
416 integral_constant<bool,
417 boost_asio_execution_set_value_fn::call_traits<R, void(Vs...)>::is_noexcept>
421 #if defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
423 template <typename R, typename... Vs>
424 constexpr bool is_nothrow_set_value_v
425 = is_nothrow_set_value<R, Vs...>::value;
427 #endif // defined(BOOST_ASIO_HAS_VARIABLE_TEMPLATES)
429 #else // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
431 template <typename R, typename = void,
432 typename = void, typename = void, typename = void, typename = void,
433 typename = void, typename = void, typename = void, typename = void>
434 struct can_set_value;
436 template <typename R, typename = void,
437 typename = void, typename = void, typename = void, typename = void,
438 typename = void, typename = void, typename = void, typename = void>
439 struct is_nothrow_set_value;
441 template <typename R>
442 struct can_set_value<R> :
443 integral_constant<bool,
444 boost_asio_execution_set_value_fn::call_traits<R, void()>::overload !=
445 boost_asio_execution_set_value_fn::ill_formed>
449 template <typename R>
450 struct is_nothrow_set_value<R> :
451 integral_constant<bool,
452 boost_asio_execution_set_value_fn::call_traits<R, void()>::is_noexcept>
456 #define BOOST_ASIO_PRIVATE_SET_VALUE_TRAITS_DEF(n) \
457 template <typename R, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
458 struct can_set_value<R, BOOST_ASIO_VARIADIC_TARGS(n)> : \
459 integral_constant<bool, \
460 boost_asio_execution_set_value_fn::call_traits<R, \
461 void(BOOST_ASIO_VARIADIC_TARGS(n))>::overload != \
462 boost_asio_execution_set_value_fn::ill_formed> \
466 template <typename R, BOOST_ASIO_VARIADIC_TPARAMS(n)> \
467 struct is_nothrow_set_value<R, BOOST_ASIO_VARIADIC_TARGS(n)> : \
468 integral_constant<bool, \
469 boost_asio_execution_set_value_fn::call_traits<R, \
470 void(BOOST_ASIO_VARIADIC_TARGS(n))>::is_noexcept> \
474 BOOST_ASIO_VARIADIC_GENERATE(BOOST_ASIO_PRIVATE_SET_VALUE_TRAITS_DEF)
475 #undef BOOST_ASIO_PRIVATE_SET_VALUE_TRAITS_DEF
477 #endif // defined(BOOST_ASIO_HAS_VARIADIC_TEMPLATES)
479 } // namespace execution
483 #endif // defined(GENERATING_DOCUMENTATION)
485 #include <boost/asio/detail/pop_options.hpp>
487 #endif // BOOST_ASIO_EXECUTION_SET_VALUE_HPP