checked_reverse_copy

Same as reverse_copy but enforces the use of a checked iterator as output iterator. checked_reverse_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 BidirectionalIterator, class OutputIterator>
   OutputIterator checked_reverse_copy(
      BidirectionalIterator_First,
      BidirectionalIterator_Last,
      OutputIterator_Result
   );

Parameters

  • _First
    A bidirectional iterator pointing to the position of the first element in the source range within which the elements are being permuted.

  • _Last
    A bidirectional iterator pointing to the position one past the final element in the source range within which the elements are being permuted.

  • _Result
    An output iterator pointing to the position of the first element in the destination range to which elements are being copied.

Return Value

An output iterator pointing to the position one past the final element in the destination range to where the altered sequence of elements is being copied.

Remarks

See reverse_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