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.
Notes
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