v3/algorithm/replace.hpp

0001 /// \file
0002 // Range v3 library
0003 //
0004 //  Copyright Eric Niebler 2014-present
0005 //
0006 //  Use, modification and distribution is subject to the
0007 //  Boost Software License, Version 1.0. (See accompanying
0008 //  file LICENSE_1_0.txt or copy at
0009 //  http://www.boost.org/LICENSE_1_0.txt)
0010 //
0011 // Project home: https://github.com/ericniebler/range-v3
0012 //
0013 #ifndef RANGES_V3_ALGORITHM_REPLACE_HPP
0014 #define RANGES_V3_ALGORITHM_REPLACE_HPP
0015
0016 #include <meta/meta.hpp>
0017
0018 #include <range/v3/range_fwd.hpp>
0019
0020 #include <range/v3/functional/identity.hpp>
0021 #include <range/v3/functional/invoke.hpp>
0022 #include <range/v3/iterator/concepts.hpp>
0023 #include <range/v3/iterator/traits.hpp>
0024 #include <range/v3/range/access.hpp>
0025 #include <range/v3/range/concepts.hpp>
0026 #include <range/v3/range/dangling.hpp>
0027 #include <range/v3/range/traits.hpp>
0028 #include <range/v3/utility/static_const.hpp>
0029
0030 #include <range/v3/detail/prologue.hpp>
0031
0032 namespace ranges
0033 {
0034     /// \addtogroup group-algorithms
0035     /// @{
0036     RANGES_FUNC_BEGIN(replace)
0037
0038         /// \brief function template \c replace
0039         template(typename I, typename S, typename T1, typename T2, typename P = identity)(
0040             requires input_iterator<I> AND sentinel_for<S, I> AND
0041                 indirectly_writable<I, T2 const &> AND
0042                 indirect_relation<equal_to, projected<I, P>, T1 const *>)
0043         constexpr I RANGES_FUNC(replace)(
0044             I first, S last, T1 const & old_value, T2 const & new_value, P proj = {}) //
0045         {
0046             for(; first != last; ++first)
0047                 if(invoke(proj, *first) == old_value)
0048                     *first = new_value;
0049             return first;
0050         }
0051
0052         /// \overload
0053         template(typename Rng, typename T1, typename T2, typename P = identity)(
0054             requires input_range<Rng> AND
0055                 indirectly_writable<iterator_t<Rng>, T2 const &> AND
0056                 indirect_relation<equal_to, projected<iterator_t<Rng>, P>, T1 const *>)
0057         constexpr borrowed_iterator_t<Rng> RANGES_FUNC(replace)(
0058             Rng && rng, T1 const & old_value, T2 const & new_value, P proj = {}) //
0059         {
0060             return (*this)(begin(rng), end(rng), old_value, new_value, std::move(proj));
0061         }
0062
0063     RANGES_FUNC_END(replace)
0064
0065     namespace cpp20
0066     {
0067         using ranges::replace;
0068     }
0069     /// @}
0070 } // namespace ranges
0071
0072 #include <range/v3/detail/epilogue.hpp>
0073
0074 #endif