Namespaces
Variants

std::map<Key,T,Compare,Allocator>:: merge

From cppreference.net

C++
Containers library
std::map
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:: map < Key, T, C2, Allocator > & source ) ;
(1) (C++17부터)
(C++26부터 constexpr)
template < class C2 >
void merge ( std:: map < Key, T, C2, Allocator > && source ) ;
(2) (C++17부터)
(C++26부터 constexpr)
template < class C2 >
void merge ( std:: multimap < Key, T, C2, Allocator > & source ) ;
(3) (C++17부터)
(C++26부터 constexpr)
template < class C2 >
void merge ( std:: multimap < Key, T, 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 <map>
#include <string>
int main()
{
    std::map<int, std::string> ma{{1, "apple"}, {5, "pear"}, {10, "banana"}};
    std::map<int, std::string> mb{{2, "zorro"}, {4, "batman"}, {5, "X"}, {8, "alpaca"}};
    std::map<int, std::string> u;
    u.merge(ma);
    std::cout << "ma.size(): " << ma.size() << '\n';
    u.merge(mb);
    std::cout << "mb.size(): " << mb.size() << '\n';
    std::cout << "mb.at(5): " << mb.at(5) << '\n';
    for (const auto& kv : u)
        std::cout << kv.first << ", " << kv.second << '\n';
}

출력: 

ma.size(): 0
mb.size(): 1
mb.at(5): X
1, apple
2, zorro
4, batman
5, pear
8, alpaca
10, banana

참고 항목

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