23 Algorithms library [algorithms]

23.6 Mutating sequence operations [alg.modifying.operations]

23.6.2 Move [alg.move]

🔗
template<class InputIterator, class OutputIterator> constexpr OutputIterator move(InputIterator first, InputIterator last, OutputIterator result);
1
#
Requires: result shall not be in the range [first, last).
2
#
Effects: Moves elements in the range [first, last) into the range [result, result + (last - first)) starting from first and proceeding to last.
For each non-negative integer n < (last-first), performs *(result + n) = std​::​move(*(first + n)).
3
#
Returns: result + (last - first).
4
#
Complexity: Exactly last - first move assignments.
🔗
template<class ExecutionPolicy, class ForwardIterator1, class ForwardIterator2> ForwardIterator2 move(ExecutionPolicy&& policy, ForwardIterator1 first, ForwardIterator1 last, ForwardIterator2 result);
5
#
Requires: The ranges [first, last) and [result, result + (last - first)) shall not overlap.
6
#
Effects: Moves elements in the range [first, last) into the range [result, result + (last - first)).
For each non-negative integer n < (last - first), performs *(result + n) = std​::​​move(*(first + n)).
7
#
Returns: result + (last - first).
8
#
Complexity: Exactly last - first assignments.
🔗
template<class BidirectionalIterator1, class BidirectionalIterator2> constexpr BidirectionalIterator2 move_backward(BidirectionalIterator1 first, BidirectionalIterator1 last, BidirectionalIterator2 result);
9
#
Requires: result shall not be in the range (first, last].
10
#
Effects: Moves elements in the range [first, last) into the range [result - (last-first), result) starting from last - 1 and proceeding to first.238
For each positive integer n <= (last - first), performs *(result - n) = std​::​move(*(last - n)).
11
#
Returns: result - (last - first).
12
#
Complexity: Exactly last - first assignments.
238)
move_­backward should be used instead of move when last is in the range [result - (last - first), result).