std::unordered_multimap

来自cppreference.com
< cpp‎ | container
 
 
容器库
序列
(C++11)
关联
无序关联
unordered_multimap
(C++11)
适配器
视图
(C++20)
 
 
定义于头文件 <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_multimap;
(1) (C++11 起)
namespace pmr {

    template <class Key, class T,
              class Hash = std::hash<Key>,
              class Pred = std::equal_to<Key>>
    using unordered_multimap = std::unordered_multimap<Key, T, Hash, Pred,
                                   std::pmr::polymorphic_allocator<std::pair<const Key,T>>>;

}
(2) (C++17 起)

unordered_multimap 是无序关联容器,支持等价的关键(一个 unordered_multimap 可含有每个关键值的多个副本)和将关键与另一类型的值关联。 unordered_multimap 类支持向前迭代器。搜索、插入和移除拥有平均常数时间复杂度。

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

不要求此容器的迭代顺序稳定(故例如 std::equal 不能用于比较二个 std::unordered_multimap ),除了关键比较等价(以 key_eq() 为比较器比较相等)的每组元素在迭代顺序中组成相接的子范围,它亦可用 equal_range() 访问。

std::unordered_multimap 满足容器 (Container) 知分配器容器 (AllocatorAwareContainer) 无序关联容器 (UnorderedAssociativeContainer) 的要求。

成员类型

成员类型 定义
key_type Key
mapped_type T
value_type std::pair<const Key, T>
size_type 无符号整数类型(通常是 std::size_t
difference_type 有符号整数类型(通常是 std::ptrdiff_t
hasher Hash
key_equal KeyEqual
allocator_type Allocator
reference value_type&
const_reference const value_type&
pointer std::allocator_traits<Allocator>::pointer
const_pointer std::allocator_traits<Allocator>::const_pointer
iterator 指向 value_type 的常老式向前迭代器 (LegacyForwardIterator)
const_iterator 指向 const value_type老式向前迭代器 (LegacyForwardIterator)
local_iterator 类别、值、差、指针和引用类型都与 iterator 相同的迭代器类型。
能用此迭代器在单个桶迭代,但不能跨桶。
const_local_iterator 类别、值、差、指针和引用类型都与 const_iterator 相同的迭代器类型。
能用此迭代器在单个桶迭代,但不能跨桶。
node_type(C++17 起) 表示容器结点的结点把柄特化

成员函数

构造 unordered_multimap
(公开成员函数)
析构 unordered_multimap
(公开成员函数)
(C++11)
赋值给容器
(公开成员函数)
返回相关的分配器
(公开成员函数)
迭代器
返回指向起始的迭代器
(公开成员函数)
(C++11)
返回指向末尾的迭代器
(公开成员函数)
容器
(C++11)
检查容器是否为空
(公开成员函数)
(C++11)
返回容纳的元素数
(公开成员函数)
(C++11)
返回可容纳的最大元素数
(公开成员函数)
修改器
(C++11)
清除内容
(公开成员函数)
(C++11)
插入元素或结点 (C++17 起)
(公开成员函数)
(C++11)
原位构造元素
(公开成员函数)
使用提示原位构造元素
(公开成员函数)
(C++11)
擦除元素
(公开成员函数)
(C++11)
交换内容
(公开成员函数)
(C++17)
从另一容器释出结点
(公开成员函数)
(C++17)
从另一容器接合结点
(公开成员函数)
查找
(C++11)
返回匹配特定键的元素数量
(公开成员函数)
(C++11)
寻找带有特定键的元素
(公开成员函数)
(C++20)
检查容器是否含有带特定键的元素
(公开成员函数)
返回匹配特定键的元素范围
(公开成员函数)
桶接口
返回一个迭代器,指向指定的桶的开始
(公开成员函数)
返回一个迭代器,指向指定的桶的末尾
(公开成员函数)
返回桶数
(公开成员函数)
返回桶的最大数量
(公开成员函数)
返回在特定的桶中的元素数量
(公开成员函数)
(C++11)
返回带有特定键的桶
(公开成员函数)
哈希策略
返回每个桶的平均元素数量
(公开成员函数)
管理每个桶的平均元素数量的最大值
(公开成员函数)
(C++11)
为至少为指定数量的桶预留存储空间并重新生成散列表
(公开成员函数)
(C++11)
为至少为指定数量的元素预留存储空间并重新生成哈希表。
(公开成员函数)
观察器
返回用于对键散列的函数
(公开成员函数)
(C++11)
返回用于比较键的相等性的函数
(公开成员函数)

非成员函数

(C++20 中移除)
比较 unordered_multimap 中的值
(函数模板)
特化 std::swap 算法
(函数模板)
擦除所有满足特定判别标准的元素
(函数模板)

推导指引(C++17 起)