checked_rotate_copy

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

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

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

Reference

Standard Template Library

Other Resources

<algorithm> Members