std::unique

template< class ForwardIt >
ForwardIt unique( ForwardIt first, ForwardIt last );

template< class ExecutionPolicy, class ForwardIt >
ForwardIt unique( ExecutionPolicy&& policy,
                  ForwardIt first, ForwardIt last );

template< class ForwardIt, class BinaryPred >
ForwardIt unique( ForwardIt first, ForwardIt last, BinaryPred p );

template< class ExecutionPolicy,
          class ForwardIt, class BinaryPred >
ForwardIt unique( ExecutionPolicy&& policy,
                  ForwardIt first, ForwardIt last, BinaryPred p );

범위 [first, last)에서 연속된 동등 요소 그룹 각각에서 첫 번째 요소를 제외한 모든 요소를 제거하고, 범위의 새로운 끝을 나타내는 past-the-end 반복자를 반환합니다.

설명

제거는 범위 내 요소들을 이동시켜 제거되지 않을 요소들이 범위의 시작 부분에 나타나도록 하는 방식으로 수행됩니다.

• 시프팅은 copy assignment (until C++11) move assignment (since C++11) 에 의해 수행됩니다.
• 제거 작업은 안정적입니다: 제거되지 않는 요소들의 상대적 순서는 유지됩니다.
• [ first , last ) 의 기본 시퀀스는 제거 작업에 의해 단축되지 않습니다. 반환된 반복자로 result 가 주어집니다:

• [ result , last ) 범위 내의 모든 반복자는 여전히 역참조 가능 합니다.

매개변수

반환값

범위의 새로운 끝을 가리키는 ForwardIt 입니다.

복잡도

주어진 \(\scriptsize N\) N 이 std:: distance ( first, last ) 인 경우:

예외

ExecutionPolicy 라는 템플릿 매개변수를 사용하는 오버로드는 다음과 같이 오류를 보고합니다:

• 알고리즘의 일부로 호출된 함수 실행 중 예외가 발생하고 ExecutionPolicy 가 표준 정책 중 하나인 경우, std::terminate 가 호출됩니다. 다른 ExecutionPolicy 의 경우 동작은 구현에 따라 정의됩니다.
• 알고리즘이 메모리 할당에 실패하는 경우, std::bad_alloc 이 throw됩니다.

가능한 구현

다음 구현들도 참조하십시오: libstdc++ , libc++ , 그리고 MSVC STL .

template<class ForwardIt>
ForwardIt unique(ForwardIt first, ForwardIt last)
{
    if (first == last)
        return last;
    ForwardIt result = first;
    while (++first != last)
        if (!(*result == *first) && ++result != first)
            *result = std::move(*first);
    return ++result;
}

template<class ForwardIt, class BinaryPredicate>
ForwardIt unique(ForwardIt first, ForwardIt last, BinaryPredicate p)
{
    if (first == last)
        return last;
    ForwardIt result = first;
    while (++first != last)
        if (!p(*result, *first) && ++result != first)
            *result = std::move(*first);
    return ++result;
}

참고 사항

unique 에 대한 호출은 일반적으로 컨테이너의 erase 멤버 함수 호출이 뒤따라, 실제로 컨테이너에서 요소들을 제거합니다.

예제

#include <algorithm>
#include <iostream>
#include <vector>
int main()
{
    // 여러 중복 요소를 포함하는 벡터
    std::vector<int> v{1, 2, 1, 1, 3, 3, 3, 4, 5, 4};
    auto print = [&](int id)
    {
        std::cout << "@" << id << ": ";
        for (int i : v)
            std::cout << i << ' ';
        std::cout << '\n';
    };
    print(1);
    // 연속된(인접한) 중복 제거
    auto last = std::unique(v.begin(), v.end());
    // v는 이제 {1 2 1 3 4 5 4 x x x}를 보유하며, 여기서 'x'는 불확정 값
    v.erase(last, v.end());
    print(2);
    // 모든 중복을 제거하기 위한 정렬 후 unique 적용
    std::sort(v.begin(), v.end()); // {1 1 2 3 4 4 5}
    print(3);
    last = std::unique(v.begin(), v.end());
    // v는 이제 {1 2 3 4 5 x x}를 보유하며, 여기서 'x'는 불확정 값
    v.erase(last, v.end());
    print(4);
}

@1: 1 2 1 1 3 3 3 4 5 4
@2: 1 2 1 3 4 5 4
@3: 1 1 2 3 4 4 5
@4: 1 2 3 4 5

결함 보고서

다음의 동작 변경 결함 보고서들은 이전에 발표된 C++ 표준에 소급 적용되었습니다.

같이 보기