checked_rotate_copy

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

Hinweis

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.

Return Value

An output iterator addressing the position one past the final element in the destination range.

Remarks

See rotate_copy for a code sample.

For more information on checked iterators, see Checked Iterators.

Requirements

Header: <algorithm>

Namespace: stdext

See Also

Concepts

<algorithm> Members

Standard Template Library