[#BloombergLP-bslstl-AlgorithmUtil-copyN]
= xref:BloombergLP.adoc[BloombergLP]::xref:BloombergLP/bslstl.adoc[bslstl]::xref:BloombergLP/bslstl/AlgorithmUtil.adoc[AlgorithmUtil]::copyN
:relfileprefix: ../../../
:mrdocs:

Copy a counted range of elements to an output iterator.

== Synopsis

Declared in `<bslstl_algorithm.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class t_INPUT_ITERATOR,
    class t_SIZE,
    class t_OUTPUT_ITERATOR>
static
t_OUTPUT_ITERATOR
copyN(
    t_INPUT_ITERATOR first,
    t_SIZE count,
    t_OUTPUT_ITERATOR result);
----

== Description

Copy the specified `count` elements from the specified `first` to the specified `result`. Return an iterator pointing past the last copied element in the output range.

== Return Value

iterator pointing past the last copied element in the output range

== Parameters

[cols="1,4"]
|===
| Name| Description
| *first*
| beginning of the range to copy from
| *count*
| number of elements to copy
| *result*
| beginning of the destination range
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#