std::rotate_copy

Template:cpp/algorithm/sidebar Template:ddcl list begin <tr class="t-dsc-header">

<td>

Defined in header <algorithm>

</td>

<td></td> <td></td> </tr> <tr class="t-dcl ">

<td class="t-dcl-nopad">

template< class ForwardIterator, class OutputIterator >

OutputIterator rotate_copy( ForwardIterator first, ForwardIterator n_first,

                            ForwardIterator last, OutputIterator d_first );

</td>

<td class="t-dcl-nopad"> </td> <td class="t-dcl-nopad"> </td> </tr> Template:ddcl list end

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.

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

Return value

output iterator to the element past the last element copied.

Complexity

linear in the distance between first and last

See also

Template:cpp/algorithm/dcl list rotate