unchecked_copy_backward

Same as copy_backward, but allows the use of an unchecked iterator as output iterator when _SECURE_SCL=1 is defined. unchecked_copy_backward 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 BidirectionalIterator1, class BidirectionalIterator2>
   BidirectionalIterator2 unchecked_copy_backward(
      BidirectionalIterator1_First, 
      BidirectionalIterator1 _Last,
      BidirectionalIterator2 _DestEnd
   );

Parameters

  • _First
    A bidirectional iterator addressing the position of the first element in the source range.

  • _Last
    A bidirectional iterator addressing the position that is one past the final element in the source range.

  • _DestEnd
    A bidirectional iterator addressing the position of the one past the final element in the destination range.

Return Value

An output iterator addressing the position that is one past the final element in the destination range, that is, the iterator addresses _ DestEnd – (_Last – _First ).

Remarks

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