Share via


checked_copy

Same as copy, but enforces the use of a checked iterator as output iterator. checked_copy is defined in the stdext namespace.

Note

This algorithm is a Microsoft extension to the Standard C++ Library. Code implemented using this algorithm will not be portable.

template<class InputIterator, class OutputIterator>
   OutputIterator checked_copy(
      InputIterator_First, 
      InputIterator _Last, 
      OutputIterator _DestBeg
   );

Parameters

  • _First
    An input iterator addressing the position of the first element in the source range.

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

  • _DestBeg
    An output iterator addressing the position of the first 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 _Result + (_Last – _First ).

Remarks

See 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