Move-assigns a sequence of elements addressed by a pair of input iterators to a destination specified by an output iterator.
- Template Parameters
-
InputIterator | The type of an input iterator which addresses the input sequence of elements to move. |
OutputIterator | The type of an output iterator specifying the destination of the move operation. |
- Parameters
-
start | The input iterator associated with the beginning of the input sequence of elements to move. |
end | The input iterator associated with the past-the-end position of the input sequence. |
output | The output iterator. |
- Returns
- The output iterator after the move operation, i.e. the iterator associated with the position in the destination after the last moved-in element, or
output
, if the input sequence is empty.
- Exceptions
-
Any | exception that originates from move-assignment of the sequence elements. |
The function behaves exactly like the standard std::move except that the input and output sequences must not overlap in memory.
If the move-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 move into uninitialized memory, use construct_move.
- Examples
- chsvmath\algebraic_traits.cpp.