checked_remove_copy_if

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.

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

Concepts

<algorithm> Members

Standard Template Library