arrayCopyBackward

Function

arrayCopyBackward

Copies a range of objects into another range of objects starting from the last element.

arrayCopyBackward(source_begin, source_end, target)

Parameters

source_begin	Iterator to the first element of the source array.
source_end	Iterator behind the last element of the source array. source_end must have the same type as source_begin.
target	Iterator to the first element of the target array. The target capacity should be at least as long as the source range.

Remarks

If there is no need for the source elements to persist, consider to use arrayMoveBackward instead to improve performance.

Note: Be careful if source and target range overlap, because in this case some source elements could be accidently overwritten before they are moved.

If source and target do not overlap, consider to use the function arrayCopyForward instead that is faster in some cases.

Note: The semantic of this function's argument target differ from the arguments of ::std::copy_backward.