rotate_copy

The function rotate_copy is used to copy a sequence with a rotated order.

  template<class ForwardIterator, class OutputIterator>
  OutputIterator rotate_copy
  (ForwardIterator first, ForwardIterator middle,
  ForwardIterator last, OutputIterator result);
  
Remarks

The position of the last copied element is returned.