定义于头文件
template< class Key, | (1) | (C++11 起) |
namespace pmr { template | (2) | (C++17 起) |
unordered_map 是关联容器,含有带唯一键的键-值 pair 。搜索、插入和元素移除拥有平均常数时间复杂度。
元素在内部不以任何特定顺序排序,而是组织进桶中。元素放进哪个桶完全依赖于其键的哈希。这允许对单独元素的快速访问,因为一旦计算哈希,则它准确指代元素所放进的桶。
std::unordered_map::emplace
template< class... Args > | (C++11 起) |
若容器中无拥有该关键的元素,则插入以给定的 args
原位构造的新元素到容器。
细心地使用 emplace
允许在构造新元素的同时避免不必要的复制或移动操作。 准确地以与提供给 emplace
者相同的参数,通过 std::forward
若因插入发生重哈希,则所有迭代器都被非法化。否则迭代器不受影响。引用不被非法化。重哈希仅若新元素数量大于 max_load_factor()*bucket_count() 才发生。
args | - | 要转发给元素构造函数的参数 |
返回由指向被插入元素,或若不发生插入则为既存元素的迭代器,和指代插入是否发生的 bool (若发生插入则为 true ,否则为 false )。
若任何操作抛出异常,则此函数无效果。
平均为均摊常数,最坏情况与容器大小成线性。
std::unordered_map::emplace_hint
template | (C++11 起) |
插入新元素到容器,以 hint
为应当放置新元素位置的建议。原位构造元素,即不进行复制或移动操作。
准确地以与提供给函数者相同的参数,以 std::forwardvalue_type
即 std::pair
若因插入发生重哈希,则所有迭代器都被非法化。否则迭代器不受影响。引用不被非法化。重哈希仅若新元素数量大于 max_load_factor()*bucket_count() 才发生。
hint | - | 迭代器,用作插入新元素位置的建议 |
args | - | 转发给元素构造函数的参数 |
返回指向新插入元素的迭代器。
若因元素已存在而插入失败,则返回指向带等价关键的既存元素。
若任何操作抛出异常,则此函数无效果(强异常保证)。
平均为均摊常数,最坏情况与容器大小成线性。
std::unordered_map::swap
void swap( unordered_map& other ); | (C++11 起) (C++17 前) | |
void swap( unordered_map& other ) noexcept(/* see below */); | (C++17 起) |
将内容与 other
的交换。不在单个元素上调用任何移动、复制或交换操作。
所有迭代器和引用保持合法。尾后迭代器被非法化。
Hash
和 KeyEqual
对象必须可交换 (Swappable) ,并用非成员 swap
的非限定调用交换它们。
若 std::allocator_traits | (C++11 起) |
other | - | 要与之交换内容的容器 |
(无)
任何 | (C++17 前) |
noexcept 规定: noexcept(std::allocator_traits && std::is_nothrow_swappable | (C++17 起) |
常数。