1 /*=============================================================================
2 Copyright (c) 2015 Paul Fultz II
4 Distributed under the Boost Software License, Version 1.0. (See accompanying
5 file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6 ==============================================================================*/
8 #ifndef BOOST_HOF_GUARD_UNPACK_H
9 #define BOOST_HOF_GUARD_UNPACK_H
17 /// The `unpack` function adaptor takes a sequence and uses the elements of
18 /// the sequence for the arguments to the function. Multiple sequences can be
19 /// passed to the function. All elements from each sequence will be passed
20 /// into the function.
27 /// unpack_adaptor<F> unpack(F f);
34 /// * [ConstInvocable](ConstInvocable)
35 /// * MoveConstructible
40 /// #include <boost/hof.hpp>
41 /// #include <cassert>
42 /// using namespace boost::hof;
46 /// template<class T, class U>
47 /// T operator()(T x, U y) const
54 /// int r = unpack(sum())(std::make_tuple(3,2));
61 /// * [std::apply](http://en.cppreference.com/w/cpp/utility/apply) - C++17 function to unpack a tuple
62 /// * [`unpack_sequence`](unpack_sequence)
65 #include <boost/hof/unpack_sequence.hpp>
66 #include <boost/hof/is_unpackable.hpp>
67 #include <boost/hof/detail/seq.hpp>
68 #include <boost/hof/capture.hpp>
69 #include <boost/hof/always.hpp>
70 #include <boost/hof/reveal.hpp>
71 #include <boost/hof/detail/and.hpp>
72 #include <boost/hof/detail/delegate.hpp>
73 #include <boost/hof/detail/holder.hpp>
74 #include <boost/hof/detail/move.hpp>
75 #include <boost/hof/detail/make.hpp>
76 #include <boost/hof/detail/static_const_var.hpp>
78 namespace boost { namespace hof {
82 template<class F, class Sequence>
83 constexpr auto unpack_simple(F&& f, Sequence&& s) BOOST_HOF_RETURNS
85 detail::unpack_impl(BOOST_HOF_FORWARD(F)(f), BOOST_HOF_FORWARD(Sequence)(s))
88 template<class F, class... Sequences>
89 constexpr auto unpack_join(F&& f, Sequences&&... s) BOOST_HOF_RETURNS
91 boost::hof::pack_join(unpack_simple(boost::hof::pack_forward, BOOST_HOF_FORWARD(Sequences)(s))...)(BOOST_HOF_FORWARD(F)(f))
97 struct unpack_adaptor : detail::callable_base<F>
99 typedef unpack_adaptor fit_rewritable1_tag;
100 BOOST_HOF_INHERIT_CONSTRUCTOR(unpack_adaptor, detail::callable_base<F>);
102 template<class... Ts>
103 constexpr const detail::callable_base<F>& base_function(Ts&&... xs) const noexcept
105 return boost::hof::always_ref(*this)(xs...);
108 struct unpack_failure
110 template<class Failure>
115 template<class... Ts>
116 typename Failure::template of<Ts...> operator()(Ts&&...) const;
119 template<class T, class=typename std::enable_if<(
120 is_unpackable<T>::value
122 static auto deduce(T&& x)
125 boost::hof::detail::unpack_simple(deducer(), BOOST_HOF_FORWARD(T)(x))
128 template<class T, class... Ts, class=typename std::enable_if<(
129 is_unpackable<T>::value && BOOST_HOF_AND_UNPACK(is_unpackable<Ts>::value)
131 static auto deduce(T&& x, Ts&&... xs) BOOST_HOF_RETURNS
133 boost::hof::detail::unpack_join(deducer(), BOOST_HOF_FORWARD(T)(x), BOOST_HOF_FORWARD(Ts)(xs)...)
136 template<class... Ts>
138 template<class... Ts, class=typename std::enable_if<(
139 !BOOST_HOF_AND_UNPACK(is_unpackable<Ts>::value)
141 static as_failure<nop_failure> deduce(Ts&&... xs);
143 template<class... Ts>
145 #if (defined(__GNUC__) && !defined (__clang__) && __GNUC__ == 4 && __GNUC_MINOR__ < 7) || defined (_MSC_VER)
146 : std::enable_if<true, decltype(apply::deduce(std::declval<Ts>()...))>::type
148 : decltype(apply::deduce(std::declval<Ts>()...))
155 : failure_map<unpack_failure, detail::callable_base<F>>
158 BOOST_HOF_RETURNS_CLASS(unpack_adaptor);
159 template<class T, class=typename std::enable_if<(
160 is_unpackable<T>::value
162 constexpr auto operator()(T&& x) const
165 boost::hof::detail::unpack_simple(BOOST_HOF_MANGLE_CAST(const detail::callable_base<F>&)(BOOST_HOF_CONST_THIS->base_function(x)), BOOST_HOF_FORWARD(T)(x))
168 template<class T, class... Ts, class=typename std::enable_if<(
169 is_unpackable<T>::value && BOOST_HOF_AND_UNPACK(is_unpackable<Ts>::value)
171 constexpr auto operator()(T&& x, Ts&&... xs) const BOOST_HOF_RETURNS
173 boost::hof::detail::unpack_join(BOOST_HOF_MANGLE_CAST(const detail::callable_base<F>&)(BOOST_HOF_CONST_THIS->base_function(x)), BOOST_HOF_FORWARD(T)(x), BOOST_HOF_FORWARD(Ts)(xs)...)
177 BOOST_HOF_DECLARE_STATIC_VAR(unpack, detail::make<unpack_adaptor>);
179 }} // namespace boost::hof