copy_n

Copies a specified number of elements.

template<class InputIterator, class Size, class OutputIterator>
OutputIterator copy_n(InputIterator first, Size count, OutputIterator dest);

Parameters

  • first
    An input iterator that indicates where to copy elements from.

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

  • dest
    An output iterator that indicates where to copy elements to.

Return Value

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

Remarks

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).

Requirements

Header: <algorithm>

Namespace: std

See Also

Reference

<algorithm>