checked_remove_copy

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

注意

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_remove_copy(
      InputIterator_First,
      InputIterator_Last,
      OutputIterator _Result,
      const Type& _Val
   );

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.

• _Val
  The value that is to be removed from the range.

Return Value

A forward iterator addressing the new end position of the destination range, one past the final element of the copy of the remnant sequence free of the specified value.

Remarks

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