c++11 标准模板（STL）（std::unordered_map）

Posted 2023-03-13 繁星璀璨G

定义于头文件 <unordered_map>

template<     class Key,     class T,     class Hash = std::hash<Key>,     class KeyEqual = std::equal_to<Key>,     class Allocator = std::allocator< std::pair<const Key, T> > > class unordered_map;	(1)	(C++11 起)
namespace pmr     template <class Key,               class T,               class Hash = std::hash<Key>,               class KeyEqual = std::equal_to<Key>>               using unordered_map = std::unordered_map<Key, T, Hash, Pred,                               std::pmr::polymorphic_allocator<std::pair<const Key,T>>>;	(2)	(C++17 起)

 

unordered_map 是关联容器，含有带唯一键的键-值 pair 。搜索、插入和元素移除拥有平均常数时间复杂度。

元素在内部不以任何特定顺序排序，而是组织进桶中。元素放进哪个桶完全依赖于其键的哈希。这允许对单独元素的快速访问，因为一旦计算哈希，则它准确指代元素所放进的桶。

修改器

原位构造元素

std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::emplace

template< class... Args > std::pair<iterator,bool> emplace( Args&&... args );

(C++11 起)

 若容器中无拥有该关键的元素，则插入以给定的 args 原位构造的新元素到容器。

细心地使用 emplace 允许在构造新元素的同时避免不必要的复制或移动操作。 准确地以与提供给 emplace 者相同的参数，通过 std::forward<Args>(args)... 转发调用新元素（即 std::pair<const Key, T> ）的构造函数。 即使容器中已有拥有该关键的元素，也可能构造元素，该情况下新构造的元素将被立即销毁。

若因插入发生重哈希，则所有迭代器都被非法化。否则迭代器不受影响。引用不被非法化。重哈希仅若新元素数量大于 max_load_factor()*bucket_count() 才发生。

参数

args

-

要转发给元素构造函数的参数

返回值

返回由指向被插入元素，或若不发生插入则为既存元素的迭代器，和指代插入是否发生的 bool （若发生插入则为 true ，否则为 false ）。

异常

若任何操作抛出异常，则此函数无效果。

复杂度

平均为均摊常数，最坏情况与容器大小成线性。

使用提示原位构造元素

std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::emplace_hint

template <class... Args> iterator emplace_hint( const_iterator hint, Args&&... args );

(C++11 起)

 插入新元素到容器，以 hint 为应当放置新元素位置的建议。原位构造元素，即不进行复制或移动操作。

准确地以与提供给函数者相同的参数，以 std::forward<Args>(args)... 转发调用元素类型（ value_type 即 std::pair<const Key, T> ）的构造函数。

若因插入发生重哈希，则所有迭代器都被非法化。否则迭代器不受影响。引用不被非法化。重哈希仅若新元素数量大于 max_load_factor()*bucket_count() 才发生。

参数

hint	-	迭代器，用作插入新元素位置的建议
args	-	转发给元素构造函数的参数

返回值

返回指向新插入元素的迭代器。

若因元素已存在而插入失败，则返回指向带等价关键的既存元素。

异常

若任何操作抛出异常，则此函数无效果（强异常保证）。

复杂度

平均为均摊常数，最坏情况与容器大小成线性。

交换内容

std::unordered_map<Key,T,Hash,KeyEqual,Allocator>::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<allocator_type>::propagate_on_container_swap::value 为 true ，则用非成员 swap 的非限定调用交换分配器。否则，不交换它们（且若 get_allocator() != other.get_allocator() ，则行为未定义）。

(C++11 起)

参数

other

-

要与之交换内容的容器

返回值

（无）

异常

任何 Hash 或 KeyEqual 对象交换所抛的异常。	(C++17 前)
noexcept 规定：  noexcept(std::allocator_traits<Allocator>::is_always_equal::value && std::is_nothrow_swappable<Hash>::value && std::is_nothrow_swappable<key_equal>::value)	(C++17 起)

复杂度

常数。