1 /*
2 Copyright (c) Marshall Clow 2011-2012.
3
4 Distributed under the Boost Software License, Version 1.0. (See accompanying
5 file LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
6 */
7
8 /// \file copy_n.hpp
9 /// \brief Copy n items from one sequence to another
10 /// \author Marshall Clow
11
12 #ifndef BOOST_ALGORITHM_COPY_N_HPP
13 #define BOOST_ALGORITHM_COPY_N_HPP
14
15 #include <boost/config.hpp>
16
17 namespace boost { namespace algorithm {
18
19 /// \fn copy_n ( InputIterator first, Size n, OutputIterator result )
20 /// \brief Copies exactly n (n > 0) elements from the range starting at first to
21 /// the range starting at result.
22 /// \return The updated output iterator
23 ///
24 /// \param first The start of the input sequence
25 /// \param n The number of elements to copy
26 /// \param result An output iterator to write the results into
27 /// \note This function is part of the C++2011 standard library.
28 template <typename InputIterator, typename Size, typename OutputIterator>
copy_n(InputIterator first,Size n,OutputIterator result)29 BOOST_CXX14_CONSTEXPR OutputIterator copy_n ( InputIterator first, Size n, OutputIterator result )
30 {
31 for ( ; n > 0; --n, ++first, ++result )
32 *result = *first;
33 return result;
34 }
35 }} // namespace boost and algorithm
36
37 #endif // BOOST_ALGORITHM_COPY_IF_HPP
38