std::rotate_copy

From cppreference.com
 
 
 
Defined in header <algorithm>
template< class ForwardIterator, class OutputIterator >

OutputIterator rotate_copy( ForwardIterator first, ForwardIterator n_first,

                            ForwardIterator last, OutputIterator d_first );

Copies the elements from the range [first, last), to another range beginning at d_first in such a way, that the element n_first becomes the first element of the new range and n_first - 1 becomes the last element.

Contents

[edit] Parameters

first, last - the range of elements to copy
n_first - the element to move to the beginning of the new range
d_first - beginning of the destination range

[edit] Return value

output iterator to the element past the last element copied.

[edit] Possible implementation

[edit] Example

[edit] Complexity

linear in the distance between first and last

[edit] See also

rotates the order of elements in a range
(function template)