copy_n()

OutputIterator Chusov::Memory::copy_n ( InputIterator  input, std::size_t  size, OutputIterator  output  )

noexcept

Copy-assigns a given number of elements starting from one referred to by an input iterator to a place addressed by an output iterator.

Template Parameters

InputIterator	The type of an input iterator which addresses the start of a sequence of elements to copy.
OutputIterator	The type of an output iterator specifying the destination of the copy operation.

Parameters

input	The input iterator associated with the beginning of the input sequence of elements to copy.
size	The number of elements in the input sequence to copy.
output	The output iterator.

Returns

The output iterator after the copy operation, i.e. the iterator associated with the position in the destination after the last copied element, or output, if size is zero.

Exceptions

Any	exception that originates from copy-assignment of the sequence elements.

The function behaves exactly like the standard std::copy_n except that the input and output sequences must not overlap in memory.

If the copy-assignment is direct, i.e. dereferencing of the output iterator yields an actual address in memory rather than some proxy, and the assignment used is defined for two objects of the type T, then the output sequence must contain valid elements of the type T prior to the operation, i.e. the destination memory must not be uninitialized. To copy into uninitialized memory, use construct_copy_n.

Examples

chsvmemex\generating_input_iterator.cpp, and chsvmemex\make_generating_input_iterator.cpp.