range/algorithm/copy_backward.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_COPY_BACKWARD_HPP_INCLUDED
0010 #define BOOST_RANGE_ALGORITHM_COPY_BACKWARD_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 copy_backward
0024 ///
0025 /// range-based version of the copy_backwards std algorithm
0026 ///
0027 /// \pre BidirectionalRange is a model of the BidirectionalRangeConcept
0028 /// \pre BidirectionalTraversalWriteableIterator is a model of the BidirectionalIteratorConcept
0029 /// \pre BidirectionalTraversalWriteableIterator is a model of the WriteableIteratorConcept
0030 template< class BidirectionalRange, class BidirectionalTraversalWriteableIterator >
0031 inline BidirectionalTraversalWriteableIterator
0032 copy_backward(const BidirectionalRange& rng,
0033               BidirectionalTraversalWriteableIterator out)
0034 {
0035     BOOST_RANGE_CONCEPT_ASSERT(( BidirectionalRangeConcept<const BidirectionalRange> ));
0036     return std::copy_backward(boost::begin(rng), boost::end(rng), out);
0037 }
0038
0039     } // namespace range
0040     using range::copy_backward;
0041 } // namespace boost
0042
0043 #endif // include guard