◐ Shell
clean mode source ↗

std::unordered_multimap - cppreference.com

来自cppreference.com

在标头 <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) 的要求。

std::unordered_multimap 的全部成员函数均为 constexpr：在常量表达式求值中创建并使用 std::unordered_multimap 对象是可能的。

然而，定义一个 constexpr std::unordered_multimap 变量通常是错误，这是因为常量求值要求任何动态分配的存储都要在相同求值中释放，而 std::unordered_multimap 的初始化器通常不符合这点。

(C++26 起)

模板形参

成员类型

类型 定义
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) 和常量表达式迭代器 (ConstexprIterator) (C++26 起) [编辑]
const_iterator 指向 const value_type 的老式向前迭代器 (LegacyForwardIterator) 和常量表达式迭代器 (ConstexprIterator) (C++26 起)[编辑]
local_iterator 迭代器类型，其类别、值、差、指针和引用类型都与 iterator 相同。
能用此迭代器在桶内遍历，但不能跨桶。[编辑]
const_local_iterator 迭代器类型，其类别、值、差、指针和引用类型都与 const_iterator 相同。
此迭代器可用于在桶内遍历，但不能跨桶。[编辑]
node_type(C++17 起) 表示容器节点的节点句柄特化[编辑]

成员函数

构造 unordered_multimap
(公开成员函数) [编辑]
析构 unordered_multimap
(公开成员函数) [编辑]
将值赋给容器
(公开成员函数) [编辑]
返回关联的分配器
(公开成员函数) [编辑]
迭代器
返回指向起始的迭代器
(公开成员函数) [编辑]
返回指向末尾的迭代器
(公开成员函数) [编辑]
容器
检查容器是否为空
(公开成员函数) [编辑]
返回元素数
(公开成员函数) [编辑]
返回可容纳的最大元素数
(公开成员函数) [编辑]
修改器
清除内容
(公开成员函数) [编辑]
插入元素或节点(C++17 起)
(公开成员函数) [编辑]
插入元素范围
(公开成员函数) [编辑]
原位构造元素
(公开成员函数) [编辑]
使用提示原位构造元素
(公开成员函数) [编辑]
擦除元素
(公开成员函数) [编辑]
交换内容
(公开成员函数) [编辑]

(C++17)

 提取容器中的节点
(公开成员函数) [编辑]

(C++17)

 从另一容器合并节点
(公开成员函数) [编辑]
查找
返回匹配特定键的元素数量
(公开成员函数) [编辑]
寻找带有特定键的元素
(公开成员函数) [编辑]

(C++20)

 检查容器是否含有带特定键的元素
(公开成员函数) [编辑]
返回匹配特定键的元素范围
(公开成员函数) [编辑]
桶接口
返回指向指定的桶的开始的迭代器
(公开成员函数) [编辑]
返回指向指定的桶的末尾的迭代器
(公开成员函数) [编辑]
返回桶数
(公开成员函数) [编辑]
返回桶的最大数量
(公开成员函数) [编辑]
返回特定的桶中的元素数量
(公开成员函数) [编辑]
返回带有特定键的桶
(公开成员函数) [编辑]
哈希策略
返回每个桶的平均元素数量
(公开成员函数) [编辑]
管理每个桶的平均元素数量的最大值
(公开成员函数) [编辑]
预留至少指定数量的桶并重新生成散列表
(公开成员函数) [编辑]
为至少指定数量的元素预留空间并重新生成散列表
(公开成员函数) [编辑]
观察器
返回用于对键求散列的函数
(公开成员函数) [编辑]
返回用于比较键的相等性的函数
(公开成员函数) [编辑]

非成员函数

注解

功能特性测试宏 值 标准 功能特性
__cpp_lib_containers_ranges 202202L (C++23) 容器的范围构造和插入
__cpp_lib_constexpr_unordered_map 202502L (C++26) constexpr std::unordered_multimap

示例

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告 应用于 出版时的行为 正确行为
LWG 2050 C++11 reference、const_reference、pointer 和
const_pointer 的定义都基于 allocator_type 		基于 value_type 和
std::allocator_traits

参阅