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.