Share via


checked_remove_copy_if

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

Same as remove_copy_if but enforces the use of a checked iterator as output iterator. checked_remove_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>
   OutputIterator checked_remove_copy_if(
      InputIterator_First,
      InputIterator _Last,
      OutputIterator _Result,
      Predicate _Pred
   );

Parameters

  • _First
    An input iterator addressing the position of the first element in the range from which elements are being removed.

  • _Last
    An input iterator addressing the position one past the final element in the range from which elements are being removed.

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

  • _Pred
    The unary predicate that must be satisfied is the value of an element is to be replaced.

Return Value

A forward iterator addressing the new end position of the destination range, one past the final element of the remnant sequence free of the elements satisfying the predicate.

Remarks

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