Home C&C++函数库 c++ 语法 程序源码 Linux C库

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是该类型的一个对象,ab是键值, 如果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成员函数的引用中,这些相同的名称(KeyTHashPredAlloc)被假定为模板形参。

☉  成员类型


以下别名是unordered_multimap的成员类型。它们被广泛用作成员函数的形参和返回类型:
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相同

☞ 成员函数



(constructor) unordered_multimap构造函数 (公众成员函数)
(destructor) unordered_multimap析构函数(公众成员函数)
operator= 复制容器内容(公众成员函数)

迭代器:
begin 返回一个指向unordered_multimap容器或其中一个桶开头的迭代器 (公众成员函数)
end 返回一个指向unordered_multimap容器或其中一个桶末尾元素的下一个元素的迭代器 (公众成员函数)
cbegin 返回一个指向unordered_multimap容器或其中一个桶开头的常量迭代器 (公众成员函数)
cend 返回一个指向unordered_multimap容器或其中一个桶末尾元素的下一个元素的常量迭代器 (公众成员函数)
容量:
empty 测试容器是否为空 (公众成员函数)
size 返回容量 (公众成员函数)
max_size 返回最大元素容量(公众成员函数)
查找元素:
find 获取元素的迭代器 (公众成员函数)
count 计数具有特定键的元素 (公众成员函数)
equal_range 获取具有特定键的元素范围(公众成员函数)
修改器:
insert 插入元素(公众成员函数)
erase 删除元素(公众成员函数)
swap 交换内容(公众成员函数)
clear 清除内容(公众成员函数)
emplace 构造和插入元素(公众成员函数)
emplace_hint 构造插入元素并加提示(公众成员函数)
查看:
hash_function 获取哈希函数(公众成员函数)
key_eq 获取键的等价谓词(公众成员函数)
get_allocator 获取分配器(公众成员函数)
存储桶:
bucket_count 返回存储桶的数量(公众成员函数)
max_bucket_count 返回存储桶的最大数量(公众成员函数)
bucket_size 返回存储桶的容量(公众成员函数)
bucket 定位元素的存储桶(公众成员函数)
哈希策略:
load_factor 返回存储桶的元素平均数量(负载系数)(公众成员函数)
max_load_factor 获取或设置存储桶最大的负载系数(公众成员函数)
rehash 设置存储桶数(公众成员函数)
reserve 重组存储桶(公众成员函数)
非成员函数重载:
operators (unordered_multimap) unordered_multimap的关系操作符(函数模板)
swap (unordered_multimap) 交换两个unordered_multimap容器的内容(函数模板)

联系我们 免责声明 关于CandCplus 网站地图