range/algorithm/rotate_copy.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_ROTATE_COPY_HPP_INCLUDED
0010 #define BOOST_RANGE_ALGORITHM_ROTATE_COPY_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 <boost/range/iterator.hpp>
0017 #include <algorithm>
0018
0019 namespace boost
0020 {
0021     namespace range
0022     {
0023
0024     /// \brief template function rotate
0025     ///
0026     /// range-based version of the rotate std algorithm
0027     ///
0028     /// \pre Rng meets the requirements for a Forward range
0029     template<typename ForwardRange, typename OutputIterator>
0030     inline OutputIterator rotate_copy(
0031         const ForwardRange&                                             rng,
0032         BOOST_DEDUCED_TYPENAME range_iterator<const ForwardRange>::type middle,
0033         OutputIterator                                                  target
0034         )
0035     {
0036         BOOST_RANGE_CONCEPT_ASSERT(( ForwardRangeConcept<const ForwardRange> ));
0037         return std::rotate_copy(boost::begin(rng), middle, boost::end(rng), target);
0038     }
0039
0040     } // namespace range
0041     using range::rotate_copy;
0042 } // namespace boost
0043
0044 #endif // include guard