checked_unique_copy

Same as unique_copy but enforces the use of a checked iterator as output iterator. checked_unique_copy 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>
   OutputIterator checked_unique_copy(
      InputIterator_First,
      InputIterator_Last,
      OutputIterator_Result
   );
template<class InputIterator, class OutputIterator, class BinaryPredicate>
   OutputIterator checked_unique_copy(
      InputIterator_First,
      InputIterator_Last,
      OutputIterator_Result,
      BinaryPredicate_Comp,
   );

Parameters

  • _First
    A forward iterator addressing the position of the first element in the source range to be copied.

  • _Last
    A forward iterator addressing the position one past the final element in the source range to be copied.

  • _Result
    An output iterator addressing the position of the first element in the destination range that is receiving the copy with consecutive duplicates removed.

  • _Comp
    User-defined predicate function object that defines the condition to be satisfied if two elements are to be taken as equivalent. A binary predicate takes two arguments and returns true when satisfied and false when not satisfied.

Return Value

An output iterator addressing the position one past the final element in the destination range that is receiving the copy with consecutive duplicates removed.

Remarks

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