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 ( /* see below */ ) ;
(自 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 处于有效但未指定的状态。
若 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 的大小呈线性关系，除非分配器不相等且不传播，此时与 * 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 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
(公开成员函数)