summaryrefslogtreecommitdiffstatshomepage
path: root/3rdparty/asio/include/asio/execution/bulk_execute.hpp
diff options
context:
space:
mode:
Diffstat (limited to '3rdparty/asio/include/asio/execution/bulk_execute.hpp')
-rw-r--r--3rdparty/asio/include/asio/execution/bulk_execute.hpp397
1 files changed, 397 insertions, 0 deletions
diff --git a/3rdparty/asio/include/asio/execution/bulk_execute.hpp b/3rdparty/asio/include/asio/execution/bulk_execute.hpp
new file mode 100644
index 00000000000..2bc13c954c0
--- /dev/null
+++ b/3rdparty/asio/include/asio/execution/bulk_execute.hpp
@@ -0,0 +1,397 @@
+//
+// execution/bulk_execute.hpp
+// ~~~~~~~~~~~~~~~~~~~~~~~~~~
+//
+// Copyright (c) 2003-2021 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_BULK_EXECUTE_HPP
+#define ASIO_EXECUTION_BULK_EXECUTE_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/bulk_guarantee.hpp"
+#include "asio/execution/detail/bulk_sender.hpp"
+#include "asio/execution/executor.hpp"
+#include "asio/execution/sender.hpp"
+#include "asio/traits/bulk_execute_member.hpp"
+#include "asio/traits/bulk_execute_free.hpp"
+
+#include "asio/detail/push_options.hpp"
+
+#if defined(GENERATING_DOCUMENTATION)
+
+namespace asio {
+namespace execution {
+
+/// A customisation point that creates a bulk sender.
+/**
+ * The name <tt>execution::bulk_execute</tt> denotes a customisation point
+ * object. If <tt>is_convertible_v<N, size_t></tt> is true, then the expression
+ * <tt>execution::bulk_execute(S, F, N)</tt> for some subexpressions
+ * <tt>S</tt>, <tt>F</tt>, and <tt>N</tt> is expression-equivalent to:
+ *
+ * @li <tt>S.bulk_execute(F, N)</tt>, if that expression is valid. If the
+ * function selected does not execute <tt>N</tt> invocations of the function
+ * object <tt>F</tt> on the executor <tt>S</tt> in bulk with forward progress
+ * guarantee <tt>asio::query(S, execution::bulk_guarantee)</tt>, and
+ * the result of that function does not model <tt>sender<void></tt>, the
+ * program is ill-formed with no diagnostic required.
+ *
+ * @li Otherwise, <tt>bulk_execute(S, F, N)</tt>, if that expression is valid,
+ * with overload resolution performed in a context that includes the
+ * declaration <tt>void bulk_execute();</tt> and that does not include a
+ * declaration of <tt>execution::bulk_execute</tt>. If the function selected
+ * by overload resolution does not execute <tt>N</tt> invocations of the
+ * function object <tt>F</tt> on the executor <tt>S</tt> in bulk with forward
+ * progress guarantee <tt>asio::query(E,
+ * execution::bulk_guarantee)</tt>, and the result of that function does not
+ * model <tt>sender<void></tt>, the program is ill-formed with no diagnostic
+ * required.
+ *
+ * @li Otherwise, if the types <tt>F</tt> and
+ * <tt>executor_index_t<remove_cvref_t<S>></tt> model <tt>invocable</tt> and
+ * if <tt>asio::query(S, execution::bulk_guarantee)</tt> equals
+ * <tt>execution::bulk_guarantee.unsequenced</tt>, then
+ *
+ * - Evaluates <tt>DECAY_COPY(std::forward<decltype(F)>(F))</tt> on the
+ * calling thread to create a function object <tt>cf</tt>. [Note:
+ * Additional copies of <tt>cf</tt> may subsequently be created. --end
+ * note.]
+ *
+ * - For each value of <tt>i</tt> in <tt>N</tt>, <tt>cf(i)</tt> (or copy of
+ * <tt>cf</tt>)) will be invoked at most once by an execution agent that is
+ * unique for each value of <tt>i</tt>.
+ *
+ * - May block pending completion of one or more invocations of <tt>cf</tt>.
+ *
+ * - Synchronizes with (C++Std [intro.multithread]) the invocations of
+ * <tt>cf</tt>.
+ *
+ * @li Otherwise, <tt>execution::bulk_execute(S, F, N)</tt> is ill-formed.
+ */
+inline constexpr unspecified bulk_execute = unspecified;
+
+/// A type trait that determines whether a @c bulk_execute expression is
+/// well-formed.
+/**
+ * Class template @c can_bulk_execute is a trait that is derived from @c
+ * true_type if the expression <tt>execution::bulk_execute(std::declval<S>(),
+ * std::declval<F>(), std::declval<N>)</tt> is well formed; otherwise @c
+ * false_type.
+ */
+template <typename S, typename F, typename N>
+struct can_bulk_execute :
+ integral_constant<bool, automatically_determined>
+{
+};
+
+} // namespace execution
+} // namespace asio
+
+#else // defined(GENERATING_DOCUMENTATION)
+
+namespace asio_execution_bulk_execute_fn {
+
+using asio::declval;
+using asio::enable_if;
+using asio::execution::bulk_guarantee_t;
+using asio::execution::detail::bulk_sender;
+using asio::execution::executor_index;
+using asio::execution::is_sender;
+using asio::is_convertible;
+using asio::is_same;
+using asio::remove_cvref;
+using asio::result_of;
+using asio::traits::bulk_execute_free;
+using asio::traits::bulk_execute_member;
+using asio::traits::static_require;
+
+void bulk_execute();
+
+enum overload_type
+{
+ call_member,
+ call_free,
+ adapter,
+ ill_formed
+};
+
+template <typename S, typename Args, typename = void, typename = void,
+ typename = void, typename = void, typename = void, typename = void>
+struct call_traits
+{
+ ASIO_STATIC_CONSTEXPR(overload_type, overload = ill_formed);
+ ASIO_STATIC_CONSTEXPR(bool, is_noexcept = false);
+ typedef void result_type;
+};
+
+template <typename S, typename F, typename N>
+struct call_traits<S, void(F, N),
+ typename enable_if<
+ is_convertible<N, std::size_t>::value
+ >::type,
+ typename enable_if<
+ bulk_execute_member<S, F, N>::is_valid
+ >::type,
+ typename enable_if<
+ is_sender<
+ typename bulk_execute_member<S, F, N>::result_type
+ >::value
+ >::type> :
+ bulk_execute_member<S, F, N>
+{
+ ASIO_STATIC_CONSTEXPR(overload_type, overload = call_member);
+};
+
+template <typename S, typename F, typename N>
+struct call_traits<S, void(F, N),
+ typename enable_if<
+ is_convertible<N, std::size_t>::value
+ >::type,
+ typename enable_if<
+ !bulk_execute_member<S, F, N>::is_valid
+ >::type,
+ typename enable_if<
+ bulk_execute_free<S, F, N>::is_valid
+ >::type,
+ typename enable_if<
+ is_sender<
+ typename bulk_execute_free<S, F, N>::result_type
+ >::value
+ >::type> :
+ bulk_execute_free<S, F, N>
+{
+ ASIO_STATIC_CONSTEXPR(overload_type, overload = call_free);
+};
+
+template <typename S, typename F, typename N>
+struct call_traits<S, void(F, N),
+ typename enable_if<
+ is_convertible<N, std::size_t>::value
+ >::type,
+ typename enable_if<
+ !bulk_execute_member<S, F, N>::is_valid
+ >::type,
+ typename enable_if<
+ !bulk_execute_free<S, F, N>::is_valid
+ >::type,
+ typename enable_if<
+ is_sender<S>::value
+ >::type,
+ typename enable_if<
+ is_same<
+ typename result_of<
+ F(typename executor_index<typename remove_cvref<S>::type>::type)
+ >::type,
+ typename result_of<
+ F(typename executor_index<typename remove_cvref<S>::type>::type)
+ >::type
+ >::value
+ >::type,
+ typename enable_if<
+ static_require<S, bulk_guarantee_t::unsequenced_t>::is_valid
+ >::type>
+{
+ ASIO_STATIC_CONSTEXPR(overload_type, overload = adapter);
+ ASIO_STATIC_CONSTEXPR(bool, is_noexcept = false);
+ typedef bulk_sender<S, F, N> result_type;
+};
+
+struct impl
+{
+#if defined(ASIO_HAS_MOVE)
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(F, N)>::overload == call_member,
+ typename call_traits<S, void(F, N)>::result_type
+ >::type
+ operator()(S&& s, F&& f, N&& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(F, N)>::is_noexcept))
+ {
+ return ASIO_MOVE_CAST(S)(s).bulk_execute(
+ ASIO_MOVE_CAST(F)(f), ASIO_MOVE_CAST(N)(n));
+ }
+
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(F, N)>::overload == call_free,
+ typename call_traits<S, void(F, N)>::result_type
+ >::type
+ operator()(S&& s, F&& f, N&& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(F, N)>::is_noexcept))
+ {
+ return bulk_execute(ASIO_MOVE_CAST(S)(s),
+ ASIO_MOVE_CAST(F)(f), ASIO_MOVE_CAST(N)(n));
+ }
+
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(F, N)>::overload == adapter,
+ typename call_traits<S, void(F, N)>::result_type
+ >::type
+ operator()(S&& s, F&& f, N&& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(F, N)>::is_noexcept))
+ {
+ return typename call_traits<S, void(F, N)>::result_type(
+ ASIO_MOVE_CAST(S)(s), ASIO_MOVE_CAST(F)(f),
+ ASIO_MOVE_CAST(N)(n));
+ }
+#else // defined(ASIO_HAS_MOVE)
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(const F&, const N&)>::overload == call_member,
+ typename call_traits<S, void(const F&, const N&)>::result_type
+ >::type
+ operator()(S& s, const F& f, const N& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(const F&, const N&)>::is_noexcept))
+ {
+ return s.bulk_execute(ASIO_MOVE_CAST(F)(f),
+ ASIO_MOVE_CAST(N)(n));
+ }
+
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(const F&, const N&)>::overload == call_member,
+ typename call_traits<S, void(const F&, const N&)>::result_type
+ >::type
+ operator()(const S& s, const F& f, const N& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(const F&, const N&)>::is_noexcept))
+ {
+ return s.bulk_execute(ASIO_MOVE_CAST(F)(f),
+ ASIO_MOVE_CAST(N)(n));
+ }
+
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(const F&, const N&)>::overload == call_free,
+ typename call_traits<S, void(const F&, const N&)>::result_type
+ >::type
+ operator()(S& s, const F& f, const N& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(const F&, const N&)>::is_noexcept))
+ {
+ return bulk_execute(s, ASIO_MOVE_CAST(F)(f),
+ ASIO_MOVE_CAST(N)(n));
+ }
+
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(const F&, const N&)>::overload == call_free,
+ typename call_traits<S, void(const F&, const N&)>::result_type
+ >::type
+ operator()(const S& s, const F& f, const N& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(const F&, const N&)>::is_noexcept))
+ {
+ return bulk_execute(s, ASIO_MOVE_CAST(F)(f),
+ ASIO_MOVE_CAST(N)(n));
+ }
+
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(const F&, const N&)>::overload == adapter,
+ typename call_traits<S, void(const F&, const N&)>::result_type
+ >::type
+ operator()(S& s, const F& f, const N& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(const F&, const N&)>::is_noexcept))
+ {
+ return typename call_traits<S, void(const F&, const N&)>::result_type(
+ s, ASIO_MOVE_CAST(F)(f), ASIO_MOVE_CAST(N)(n));
+ }
+
+ template <typename S, typename F, typename N>
+ ASIO_CONSTEXPR typename enable_if<
+ call_traits<S, void(const F&, const N&)>::overload == adapter,
+ typename call_traits<S, void(const F&, const N&)>::result_type
+ >::type
+ operator()(const S& s, const F& f, const N& n) const
+ ASIO_NOEXCEPT_IF((
+ call_traits<S, void(const F&, const N&)>::is_noexcept))
+ {
+ return typename call_traits<S, void(const F&, const N&)>::result_type(
+ s, ASIO_MOVE_CAST(F)(f), ASIO_MOVE_CAST(N)(n));
+ }
+#endif // defined(ASIO_HAS_MOVE)
+};
+
+template <typename T = impl>
+struct static_instance
+{
+ static const T instance;
+};
+
+template <typename T>
+const T static_instance<T>::instance = {};
+
+} // namespace asio_execution_bulk_execute_fn
+namespace asio {
+namespace execution {
+namespace {
+
+static ASIO_CONSTEXPR
+ const asio_execution_bulk_execute_fn::impl& bulk_execute =
+ asio_execution_bulk_execute_fn::static_instance<>::instance;
+
+} // namespace
+
+template <typename S, typename F, typename N>
+struct can_bulk_execute :
+ integral_constant<bool,
+ asio_execution_bulk_execute_fn::call_traits<
+ S, void(F, N)>::overload !=
+ asio_execution_bulk_execute_fn::ill_formed>
+{
+};
+
+#if defined(ASIO_HAS_VARIABLE_TEMPLATES)
+
+template <typename S, typename F, typename N>
+constexpr bool can_bulk_execute_v = can_bulk_execute<S, F, N>::value;
+
+#endif // defined(ASIO_HAS_VARIABLE_TEMPLATES)
+
+template <typename S, typename F, typename N>
+struct is_nothrow_bulk_execute :
+ integral_constant<bool,
+ asio_execution_bulk_execute_fn::call_traits<
+ S, void(F, N)>::is_noexcept>
+{
+};
+
+#if defined(ASIO_HAS_VARIABLE_TEMPLATES)
+
+template <typename S, typename F, typename N>
+constexpr bool is_nothrow_bulk_execute_v
+ = is_nothrow_bulk_execute<S, F, N>::value;
+
+#endif // defined(ASIO_HAS_VARIABLE_TEMPLATES)
+
+template <typename S, typename F, typename N>
+struct bulk_execute_result
+{
+ typedef typename asio_execution_bulk_execute_fn::call_traits<
+ S, void(F, N)>::result_type type;
+};
+
+} // namespace execution
+} // namespace asio
+
+#endif // defined(GENERATING_DOCUMENTATION)
+
+#include "asio/detail/pop_options.hpp"
+
+#endif // ASIO_EXECUTION_BULK_EXECUTE_HPP