range/algorithm/replace.hpp

0001 //  Copyright Neil Groves 2009. Use, modification and
0002 //  distribution is subject to the Boost Software License, Version
0003 //  1.0. (See accompanying file LICENSE_1_0.txt or copy at
0004 //  http://www.boost.org/LICENSE_1_0.txt)
0005 //
0006 //
0007 // For more information, see http://www.boost.org/libs/range/
0008 //
0009 #ifndef BOOST_RANGE_ALGORITHM_REPLACE_HPP_INCLUDED
0010 #define BOOST_RANGE_ALGORITHM_REPLACE_HPP_INCLUDED
0011
0012 #include <boost/concept_check.hpp>
0013 #include <boost/range/begin.hpp>
0014 #include <boost/range/end.hpp>
0015 #include <boost/range/concepts.hpp>
0016 #include <algorithm>
0017
0018 namespace boost
0019 {
0020     namespace range
0021     {
0022
0023 /// \brief template function replace
0024 ///
0025 /// range-based version of the replace std algorithm
0026 ///
0027 /// \pre ForwardRange is a model of the ForwardRangeConcept
0028 template< class ForwardRange, class Value >
0029 inline ForwardRange&
0030 replace(ForwardRange& rng, const Value& what,
0031         const Value& with_what)
0032 {
0033     BOOST_RANGE_CONCEPT_ASSERT(( ForwardRangeConcept<ForwardRange> ));
0034     std::replace(boost::begin(rng), boost::end(rng), what, with_what);
0035     return rng;
0036 }
0037
0038 /// \overload
0039 template< class ForwardRange, class Value >
0040 inline const ForwardRange&
0041 replace(const ForwardRange& rng, const Value& what,
0042         const Value& with_what)
0043 {
0044     BOOST_RANGE_CONCEPT_ASSERT(( ForwardRangeConcept<const ForwardRange> ));
0045     std::replace(boost::begin(rng), boost::end(rng), what, with_what);
0046     return rng;
0047 }
0048
0049     } // namespace range
0050     using range::replace;
0051 } // namespace boost;
0052
0053 #endif // include guard