Namespaces
Variants

std::set<Key,Compare,Allocator>:: merge

From cppreference.net

C++
Containers library
std::set
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
template < class C2 >
void merge ( std:: set < Key, C2, Allocator > & source ) ;
(1) (C++17부터)
(C++26부터 constexpr)
template < class C2 >
void merge ( std:: set < Key, C2, Allocator > && source ) ;
(2) (C++17부터)
(C++26부터 constexpr)
template < class C2 >
void merge ( std:: multiset < Key, C2, Allocator > & source ) ;
(3) (C++17부터)
(C++26부터 constexpr)
template < class C2 >
void merge ( std:: multiset < Key, C2, Allocator > && source ) ;
(4) (C++17부터)
(C++26부터 constexpr)

source 의 각 요소를 추출("스플라이스")하여 * this 의 비교 객체를 사용해 * this 에 삽입하려 시도합니다. * this 에 source 의 요소 키와 동등한 키를 가진 요소가 존재하면, 해당 요소는 source 에서 추출되지 않습니다. get_allocator ( ) == source. get_allocator ( ) 가 false 인 경우, 동작은 정의되지 않습니다.

요소가 복사되거나 이동되지 않으며, 컨테이너 노드의 내부 포인터만 재지정됩니다. 전달된 요소에 대한 모든 포인터와 참조는 계속 유효하지만, 이제는 * this 를 가리키며, source 를 가리키지 않습니다.

목차

매개변수

source - 노드를 전송할 호환 가능한 컨테이너

예외

비교 연산이 예외를 던지지 않는 한 예외를 던지지 않습니다.

복잡도

주어진 S 를 size ( ) 로, N 을 source. size ( ) 로 정의합니다:

1-4) S·log(S+N)

예제

이 코드 실행 
#include <iostream>
#include <set>
// 컨테이너 출력
template<class Os, class K>
Os& operator<<(Os& os, const std::set<K>& v)
{
    os << '[' << v.size() << "] {";
    bool o{};
    for (const auto& e : v)
        os << (o ? ", " : (o = 1, " ")) << e;
    return os << " }\n";
}
int main()
{
    std::set<char>
        p{'C', 'B', 'B', 'A'}, 
        q{'E', 'D', 'E', 'C'};
    std::cout << "p: " << p << "q: " << q;
    p.merge(q);
    std::cout << "p.merge(q);\n" << "p: " << p << "q: " << q;
}

출력: 

p: [3] { A, B, C }
q: [3] { C, D, E }
p.merge(q);
p: [5] { A, B, C, D, E }
q: [1] { C }

참고 항목

(C++17)
컨테이너로부터 노드를 추출합니다
(public member function)
요소들을 삽입합니다 또는 노드들 (C++17부터)
(public member function)