We recommend using Visual Studio 2017
This documentation is archived and is not being maintained.


Copies a specified number of elements.

template<class InputIterator, class Size, class OutputIterator>
    OutputIterator copy_n(
        InputIterator  _First, 
        Size _Count,
        OutputIterator _Dest


An input iterator that indicates where to copy elements from.


A signed or unsigned integer type specifying the number of elements to copy.


An output iterator that indicates where to copy elements to.

Returns an output iterator where elements have been copied to. It is the same as the returned value of the third parameter, _Dest.

The template function evaluates *(_Dest + N) = *(_First + N)) once for each N in the range [0, _Count), for strictly increasing values of N starting with the lowest value. It then returns _Dest + N. If _Dest and _First designate regions of storage, _Dest must not be in the range [_First, _Last).

Header: <algorithm>

Namespace: std