unchecked_replace_copy_if

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Same as replace_copy_if, but allows the use of an unchecked iterator as output iterator when _SECURE_SCL=1 is defined. unchecked_replace_copy_if 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, class Predicate, class Type>
   OutputIterator unchecked_replace_copy_if(
      InputIterator_First,
      InputIterator_Last,
      OutputIterator_Result,
      Predicate_Pred,
      const Type&_Val
   );

Parameters

  • _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.

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 replace_copy_if 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