Namespaces
Variants

std::unordered_map<Key,T,Hash,KeyEqual,Allocator>:: operator=

From cppreference.net

C++
Containers library
std::unordered_map
Member types
Member functions
Non-member functions
Deduction guides (C++17)
unordered_map & operator = ( const unordered_map & other ) ;
(1) (C++11부터)
(C++26부터 constexpr)
(2)
unordered_map & operator = ( unordered_map && other ) ;
(C++11부터)
(C++17까지)
unordered_map & operator = ( unordered_map && other )
noexcept ( /* 아래 참조 */ ) ;
(C++17부터)
(C++26부터 constexpr)
unordered_map & operator = ( std:: initializer_list < value_type > ilist ) ;
(3) (C++11부터)
(C++26부터 constexpr)

컨테이너의 내용을 대체합니다.

traits 를 std:: allocator_traits < allocator_type > 로 정의합니다:

1) 복사 할당 연산자. 내용을 other 의 내용 복사본으로 대체합니다.
만약 traits :: propagate_on_container_copy_assignment :: value 가 true 이면, * this 의 할당자는 other 의 복사본으로 대체됩니다. 만약 할당 후 * this 의 할당자가 이전 값과 비교하여 같지 않다면, 이전 할당자를 사용하여 메모리를 해제한 후 새로운 할당자를 사용하여 요소를 복사하기 전에 메모리를 할당합니다. 그렇지 않으면, * this 가 소유한 메모리는 가능한 경우 재사용될 수 있습니다. 어떤 경우든, 원래 * this 에 속했던 요소들은 파괴되거나 요소별 복사 할당으로 대체될 수 있습니다.
2) 이동 할당 연산자. 이동 의미론을 사용하여 내용을 other 의 내용으로 대체합니다(즉, other 의 데이터가 other 에서 이 컨테이너로 이동됩니다). other 는 이후에 유효하지만 지정되지 않은 상태가 됩니다.
만약 traits :: propagate_on_container_move_assignment :: value 가 true 이면, * this 의 할당자는 other 의 할당자 사본으로 대체됩니다. 만약 false 이고 * this 와 other 의 할당자가 동일하지 않다면, * this 는 other 가 소유한 메모리의 소유권을 취할 수 없으며, 필요에 따라 자체 할당자를 사용하여 추가 메모리를 할당하면서 각 요소를 개별적으로 이동 할당해야 합니다. 어떤 경우든 원래 * this 에 속했던 모든 요소들은 파괴되거나 요소별 이동 할당으로 대체됩니다.
3) 내용을 초기화자 목록 ilist 로 식별된 내용으로 대체합니다.

목차

매개변수

other - 데이터 소스로 사용할 다른 컨테이너
ilist - 데이터 소스로 사용할 초기화 리스트

반환값

* this

복잡도

1) * this 와 other 의 크기에 선형적으로 비례합니다.
2) * this 의 크기에 대해 선형적이며, 단 할당자(allocator)가 동등하지 않고 전파(propagate)되지 않는 경우에는 * this 와 other 의 크기에 대해 선형적입니다.
3) * this 와 ilist 의 크기에 선형적입니다.

예외

2)
noexcept 명세:
noexcept ( std:: allocator_traits < Allocator > :: is_always_equal :: value

&& std:: is_nothrow_move_assignable < Hash > :: value

&& std:: is_nothrow_move_assignable < Pred > :: value )
(C++17부터)

참고 사항

컨테이너 이동 대입 후 (오버로드 ( 2 ) ), 호환되지 않는 할당자에 의한 요소별 이동 대입이 강제되지 않는 한, other 에 대한 참조, 포인터, 반복자(끝 반복자 제외)는 유효하게 남아 있지만, 이제 * this 에 있는 요소를 참조합니다. 현재 표준은 [container.reqmts]/67 의 포괄적 명시를 통해 이 보장을 제공하며, LWG issue 2321 를 통해 더 직접적인 보장이 검토 중입니다.

예제

다음 코드는 operator = 를 사용하여 하나의 std::unordered_map 을 다른 하나에 할당합니다:

이 코드 실행 
#include <initializer_list>
#include <iostream>
#include <iterator>
#include <unordered_map>
#include <utility>
void print(const auto comment, const auto& container){
    auto size = std::size(container);
    std::cout << comment << "{ ";
    for (const auto& [key, value] : container)
        std::cout << '{' << key << ',' << value << (--size ? "}, " : "} ");
    std::cout << "}\n";
}
int main()
{
    std::unordered_map<int, int> x{{1,1}, {2,2}, {3,3}}, y, z;
    const auto w = {std::pair<const int, int>{4,4}, {5,5}, {6,6}, {7,7}};
    std::cout << "Initially:\n";
    print("x = ", x);
    print("y = ", y);
    print("z = ", z);
    std::cout << "Copy assignment copies data from x to y:\n";
    y = x;
    print("x = ", x);
    print("y = ", y);
    std::cout << "Move assignment moves data from x to z, modifying both x and z:\n";
    z = std::move(x);
    print("x = ", x);
    print("z = ", z);
    std::cout << "Assignment of initializer_list w to z:\n";
    z = w;
    print("w = ", w);
    print("z = ", z);
}

가능한 출력: 

Initially:
x = { {3,3}, {2,2}, {1,1} }
y = { }
z = { }
Copy assignment copies data from x to y:
x = { {3,3}, {2,2}, {1,1} }
y = { {3,3}, {2,2}, {1,1} }
Move assignment moves data from x to z, modifying both x and z:
x = { }
z = { {3,3}, {2,2}, {1,1} }
Assignment of initializer_list w to z:
w = { {4,4}, {5,5}, {6,6}, {7,7} }
z = { {7,7}, {6,6}, {5,5}, {4,4} }

참고 항목

unordered_map 을 생성합니다
(public member function)