/*============================================================================= Copyright (c) 2015 Paul Fultz II flow.h 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 FIT_GUARD_FUNCTION_FLOW_H #define FIT_GUARD_FUNCTION_FLOW_H /// flow /// ==== /// /// Description /// ----------- /// /// The `flow` function adaptor provides function composition. It is useful as /// an alternative to using the pipe operator `|` when chaining functions. It is /// similiar to [`compose`](compose.md) except the evaluation order is /// reversed. So, `flow(f, g)(0)` is equivalent to `g(f(0))`. /// /// /// Synopsis /// -------- /// /// template /// constexpr flow_adaptor flow(Fs... fs); /// /// Semantics /// --------- /// /// assert(flow(f, g)(xs...) == g(f(xs...))); /// /// Requirements /// ------------ /// /// Fs must be: /// /// * [Callable](concepts.md#callable) /// * MoveConstructible /// /// Example /// ------- /// /// struct increment /// { /// template /// T operator()(T x) const /// { /// return x + 1; /// } /// }; /// /// struct decrement /// { /// template /// T operator()(T x) const /// { /// return x - 1; /// } /// }; /// /// int r = flow(increment(), decrement(), increment())(3); /// assert(r == 4); /// #include #include #include #include #include #include #include #include #include namespace fit { namespace detail { template struct flow_kernel : detail::compressed_pair, detail::callable_base> { typedef detail::compressed_pair, detail::callable_base> base_type; FIT_INHERIT_CONSTRUCTOR(flow_kernel, base_type) FIT_RETURNS_CLASS(flow_kernel); template constexpr FIT_SFINAE_RESULT(const detail::callable_base&, result_of&, id_...>) operator()(Ts&&... xs) const FIT_SFINAE_RETURNS ( FIT_MANGLE_CAST(const detail::callable_base&)(FIT_CONST_THIS->second(xs...))( FIT_MANGLE_CAST(const detail::callable_base&)(FIT_CONST_THIS->first(xs...))(FIT_FORWARD(Ts)(xs)...) ) ); }; } template struct flow_adaptor : detail::flow_kernel { typedef flow_adaptor fit_rewritable_tag; typedef FIT_JOIN(flow_adaptor, Fs...) tail; typedef detail::flow_kernel base; FIT_INHERIT_DEFAULT(flow_adaptor, base) template constexpr flow_adaptor(X&& f1, Xs&& ... fs) : base(FIT_FORWARD(X)(f1), tail(FIT_FORWARD(Xs)(fs)...)) {} }; template struct flow_adaptor : detail::callable_base { typedef flow_adaptor fit_rewritable_tag; FIT_INHERIT_DEFAULT(flow_adaptor, detail::callable_base) template)> constexpr flow_adaptor(X&& f1) : detail::callable_base(FIT_FORWARD(X)(f1)) {} }; FIT_DECLARE_STATIC_VAR(flow, detail::make); } // namespace fit #endif