std::
unordered_multimap
类模板 <unordered_map>
template < class Key, // unordered_multimap::key_type
class T, // unordered_multimap::mapped_type
class Hash = hash<Key>, // unordered_multimap::hasher
class Pred = equal_to<Key>, // unordered_multimap::key_equal
class Alloc = allocator< pair<const Key,T> > // unordered_multimap::allocator_type
> class unordered_multimap;
无序的多重映射
Unordered multimap是一种关联容器,用于存储由键值和映射值组合而成的元素,
类似于unordered_map容器,但允许不同的元素拥有相同的键。
在unordered_multimap中,键值通常用于唯一标识元素,而映射值是一个具有与该键关联的内容的对象。
键和映射值的类型可能不同。
在内部,unordered_multimap 中的键和值没有按照任何特定的顺序排序,而是根据它们的哈希值将它们组织到
bucket 中,
从而允许直接通过它们的键值快速访问单个元素(平均时间复杂度为常数)。
具有等价键的元素被组合在同一个bucket中,迭代器(参见equal_range)可以遍历所有这些元素。
注意,这个容器没有在它自己的头文件中定义,而是与unordered_map共享头文件<unordered_map>。
容器中的迭代器至少是前向迭代器。
☲ 容器特性
关联
关联容器中的元素是通过键引用的,而不是通过它们在容器中的绝对位置引用的。
无序
无序容器使用哈希表来组织元素,允许通过键快速访问元素。
映射
每个元素将一个键与一个映射值相关联:键用于标识主要内容为映射值的元素。
键多个元素
容器可以保存多个具有相同键的元素。
分配器
容器使用allocator 对象动态地处理其存储需求。。
☲ 模板参数
Key
键值的类型。unordered_multimap 容器中的每个元素都由一个键值标识。
成员类型 unordered_multimap::key_type 的别名.
T
映射值的类型。unordered_multimap中的每个元素用于存储一些数据作为其映射值。
成员类型 unordered_multimap::mapped_type 。注意,这与unordered_multimap::value_type 不同(参见下文).
Hash
一种一元函数对象类型,它接受一个Key类型的对象作为参数,并基于该对象返回size_t 类型的唯一值。
这可以是实现函数调用操作符的类,也可以是指向函数的指针(参见构造函数的示例)。
默认为 hash<Key> ,它返回一个哈希值,
冲突的概率接近 1.0/std::numeric_limits<size_t>::max() 。
unordered_multimap 对象使用此函数返回的哈希值在内部组织元素,加快查找单个元素的过程。
成员类型 unordered_multimap:: hashher 的别名.
Pred
一个二元谓词,接受两个Key类型的参数,并返回布尔值。
表达式pred(a,b) ,其中pred 是该类型的一个对象,a 和b 是键值,
如果a 被认为与b 等价,则返回true 。
这可以是实现函数调用操作符的类,也可以是指向函数的指针(参见构造函数的示例)。
默认为equal_to<Key> ,其返回值与应用 equal-to operator(a==b) 相同。
unordered_multimap对象使用这个表达式来确定两个元素键是否相等。
该容器支持具有相同键的多个元素。
成员类型 unordered_multimap::key_equal 的别名。
Alloc
用于定义存储分配模型的 allocator 对象的类型。 默认情况下,
使用 allocator 类模板,它定义了最简单的内存分配模型,并且与值无关。
别名为成员类型 unordered_multimap::allocator_type .
在unordered_multimap成员函数的引用中,这些相同的名称(
Key 、
T 、
Hash 、
Pred 和
Alloc )被假定为模板形参。
☉ 成员类型
以下别名是unordered_multimap的成员类型。它们被广泛用作成员函数的形参和返回类型:
C++11
C++14
C++11:
成员类型
定义
注释
key_type
起始模板参数(Key)
mapped_type
第二个模板参数(T)
value_type
pair<const key_type,mapped_type>
hasher
第三个模板参数(Hash)
默认为: hash<key_type>
key_equal
第四个模板参数(Pred)
默认为:equal_to <key_type>
allocator_type
第五个模板参数(Alloc)
默认为:allocator<value_type>
reference
Alloc::reference
const_reference
Alloc::const_reference
pointer
Alloc::pointer
默认分配器:value_type*
const_pointer
Alloc::const_pointer
默认分配器:const value_type*
iterator
指向const value_type的前向迭代器
const_iterator
指向const value_type的前向迭代器
local_iterator
指向const value_type的前向迭代器
const_local_iterator
指向const value_type的前向迭代器
difference_type
一种有符号整型
通常与ptrdiff_t相同
size_type
无符号整型
通常与size_t相同
C++14:
成员类型
定义
注释
key_type
起始模板参数(Key)
mapped_type
第二个模板参数(T)
value_type
pair<const key_type,mapped_type>
hasher
第三个模板参数(Hash)
defaults to: hash<key_type>
key_equal
第四个模板参数(Pred)
默认为:equal_to <key_type>
allocator_type
第五个模板参数(Alloc)
默认为:allocator<value_type>
reference
value_type&
const_reference
const value_type&
pointer
allocator_traits<Alloc>::pointer
默认分配器:value_type*
const_pointer
allocator_traits<Alloc>::const_pointer
默认分配器:const value_type*
iterator
指向const value_type的前向迭代器
const_iterator
指向const value_type的前向迭代器
local_iterator
指向const value_type的前向迭代器
const_local_iterator
指向const value_type的前向迭代器
difference_type
一种有符号整型
通常与ptrdiff_t相同
size_type
无符号整型
通常与size_t相同
☞ 成员函数
迭代器:
begin
返回一个指向unordered_multimap容器或其中一个桶开头的迭代器 (公众成员函数)
end
返回一个指向unordered_multimap容器或其中一个桶末尾元素的下一个元素的迭代器 (公众成员函数)
cbegin
返回一个指向unordered_multimap容器或其中一个桶开头的常量迭代器 (公众成员函数)
cend
返回一个指向unordered_multimap容器或其中一个桶末尾元素的下一个元素的常量迭代器 (公众成员函数)
容量:
查找元素:
修改器:
查看:
存储桶:
哈希策略:
非成员函数重载: