range/algorithm/merge.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_MERGE_HPP_INCLUDED
0010 #define BOOST_RANGE_ALGORITHM_MERGE_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 merge
0024 ///
0025 /// range-based version of the merge std algorithm
0026 ///
0027 /// \pre SinglePassRange1 is a model of the SinglePassRangeConcept
0028 /// \pre SinglePassRange2 is a model of the SinglePassRangeConcept
0029 /// \pre BinaryPredicate is a model of the BinaryPredicateConcept
0030 ///
0031 template<class SinglePassRange1, class SinglePassRange2,
0032          class OutputIterator>
0033 inline OutputIterator merge(const SinglePassRange1& rng1,
0034                             const SinglePassRange2& rng2,
0035                             OutputIterator          out)
0036 {
0037     BOOST_RANGE_CONCEPT_ASSERT(( SinglePassRangeConcept<const SinglePassRange1> ));
0038     BOOST_RANGE_CONCEPT_ASSERT(( SinglePassRangeConcept<const SinglePassRange2> ));
0039     return std::merge(boost::begin(rng1), boost::end(rng1),
0040                       boost::begin(rng2), boost::end(rng2), out);
0041 }
0042
0043 /// \overload
0044 template<class SinglePassRange1, class SinglePassRange2,
0045          class OutputIterator, class BinaryPredicate>
0046 inline OutputIterator merge(const SinglePassRange1& rng1,
0047                             const SinglePassRange2& rng2,
0048                             OutputIterator          out,
0049                             BinaryPredicate         pred)
0050 {
0051     BOOST_RANGE_CONCEPT_ASSERT(( SinglePassRangeConcept<const SinglePassRange1> ));
0052     BOOST_RANGE_CONCEPT_ASSERT(( SinglePassRangeConcept<const SinglePassRange2> ));
0053     return std::merge(boost::begin(rng1), boost::end(rng1),
0054                       boost::begin(rng2), boost::end(rng2), out, pred);
0055 }
0056
0057     } // namespace range
0058     using range::merge;
0059 } // namespace boost
0060
0061 #endif // include guard