Same as rotate_copy but enforces the use of a checked iterator as output iterator. checked_rotate_copy is defined in the stdext namespace.

Note
This algorithm is a Microsoft extension to the Standard C++ Library. Code implemented using this algorithm will not be portable.

template<class ForwardIterator, class OutputIterator>
   OutputIterator checked_rotate_copy(
      ForwardIterator _First,
      ForwardIterator _Middle,
      ForwardIterator _Last,
      OutputIterator _Result
   );

Parameters

_First

A forward iterator addressing the position of the first element in the range to be rotated.

_Middle

A forward iterator defining the boundary within the range that addresses the position of the first element in the second part of the range whose elements are to be exchanged with those in the first part of the range.

_ Last

A forward iterator addressing the position one past the final element in the range to be rotated.

_Result

An output iterator addressing the position of the first element in the destination range.