checked_replace_copy
Collapse the table of content
Expand the table of content
Important This document may not represent best practices for current development, links to downloads and other resources may no longer be valid. Current recommended version can be found here. ArchiveDisclaimer

checked_replace_copy

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

NoteNote:

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, class Type>
   OutputIterator checked_replace_copy(
      InputIterator _First,
      InputIterator_Last,
      OutputIterator_Result,
      const Type&_OldVal,
      const Type&_NewVal
   );

_First

An input iterator pointing to the position of the first element in the range from which elements are being replaced.

_Last

An input iterator pointing to the position one past the final element in the range from which elements are being replaced.

_Result

An output iterator pointing to the first element in the destination range to where the altered sequence of elements is being copied.

_OldVal

The old value of the elements being replaced.

_NewVal

The new value being assigned to the elements with the old 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.

See replace_copy for a code sample.

For more information on checked iterators, see Checked Iterators.

Header: <algorithm>

Namespace: stdext

Show:
© 2016 Microsoft