std::unique_copy

template< class InputIt, class OutputIt >
OutputIt unique_copy( InputIt first, InputIt last, OutputIt d_first );

template< class ExecutionPolicy, class ForwardIt1, class ForwardIt2 >
ForwardIt2 unique_copy( ExecutionPolicy&& policy, ForwardIt1 first,
                        ForwardIt1 last, ForwardIt2 d_first );

template< class InputIt, class OutputIt, class BinaryPred >
OutputIt unique_copy( InputIt first, InputIt last,
                      OutputIt d_first, BinaryPred p );

template< class ExecutionPolicy, class ForwardIt1,
          class ForwardIt2, class BinaryPred >
ForwardIt2 unique_copy( ExecutionPolicy&& policy,
                        ForwardIt1 first, ForwardIt1 last,
                        ForwardIt2 d_first, BinaryPred p );

연속되는 동일 요소가 없도록 범위 [first, last)의 요소를 d_first에서 시작하는 다른 범위로 복사합니다. 각 동일 요소 그룹의 첫 번째 요소만 복사됩니다.

만약 *d_first = *first이 유효하지 않거나(C++20까지)*first writable to d_first이 아닌 경우(C++20부터), 프로그램은 ill-formed입니다.

소스와 대상 범위가 겹치면 동작은 정의되지 않습니다.

주어진 T을 InputIt의 값 타입이라고 할 때, 오버로드 (1) 또는 (3)이 다음 모든 조건을 만족하지 않으면 동작은 정의되지 않습니다:

• T CopyConstructible 및 CopyAssignable을 모두 만족합니다.
• 다음 모든 조건이 충족됩니다:

• OutputIt LegacyForwardIterator의 요구 사항을 충족합니다.
• OutputIt의 값 타입도 T입니다.
• T CopyAssignable입니다.

매개변수

반환값

마지막으로 기록된 요소의 다음 위치를 가리키는 출력 반복자.

복잡도

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

오버로드 (2,4) 의 경우, ForwardIt1 의 값 타입이 CopyConstructible 와 CopyAssignable 모두를 만족하지 않을 경우 성능 비용이 발생할 수 있습니다.

예외

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

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

가능한 구현

구현체는 또한 libstdc++ 와 libc++ 에서 확인할 수 있습니다.

참고 사항

만약 InputIt 이 LegacyForwardIterator 를 만족한다면, 이 함수는 중복을 감지하기 위해 입력을 재읽습니다.

그렇지 않고, OutputIt 이 LegacyForwardIterator 를 만족하며, InputIt 의 값 타입이 OutputIt 의 값 타입과 동일한 경우, 이 함수는 * d_first 와 * first 를 비교합니다.

그렇지 않으면, 이 함수는 * first 를 로컬 요소 복사본과 비교합니다.

예제

#include <algorithm>
#include <iostream>
#include <iterator>
#include <string>
int main()
{
    std::string s1 {"A string with mmmany letters!"};
    std::cout << "Before: " << s1 << '\n';
    std::string s2;
    std::unique_copy(s1.begin(), s1.end(), std::back_inserter(s2),
                     [](char c1, char c2) { return c1 == 'm' && 'm' == c2; });
    std::cout << "After:  " << s2 << '\n';
}

Before: A string with mmmany letters!
After:  A string with many letters!

결함 보고서

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

같이 보기