命名空间
变体
操作

std::unordered_multimap

来自 cppreference.com
< cpp‎ | container
 
C++
 
容器库
 
std::unordered_multimap
成员类型
成员函数
非成员函数
(直到 C++20)
推导指南 (C++17)
 
在头文件 <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)

std::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 LegacyForwardIterator 到 value_type[编辑]
const_iterator LegacyForwardIterator 到 const value_type[编辑]
local_iterator 一种迭代器类型，其类别、值、差值、指针和
引用类型与 iterator 相同。此迭代器
可用于遍历单个桶，但不能跨桶遍历[编辑]
const_local_iterator 一种迭代器类型，其类别、值、差值、指针和
引用类型与 const_iterator 相同。此迭代器
可用于遍历单个桶，但不能跨桶遍历[编辑]
node_type (自 C++17 起) node handle 的特化，表示容器节点[编辑]

[编辑] 成员函数

 构造 unordered_multimap
(公有成员函数) [编辑]
 析构 unordered_multimap
(公有成员函数) [编辑]
 将值赋给容器
(公有成员函数) [编辑]
 返回关联的分配器
(公有成员函数) [编辑]
迭代器
 返回指向开头的迭代器
(公有成员函数) [编辑]
 返回指向结尾的迭代器
(公有成员函数) [编辑]
容量
 检查容器是否为空
(公有成员函数) [编辑]
 返回元素数量
(公有成员函数) [编辑]
 返回最大可能的元素数量
(公有成员函数) [编辑]
修改器
 清除内容
(公有成员函数) [编辑]
 插入元素 或节点(自 C++17 起)
(公有成员函数) [编辑]
(C++23)
 插入一系列元素
(公有成员函数) [编辑]
 就地构造元素
(公有成员函数) [编辑]
 使用提示就地构造元素
(公有成员函数) [编辑]
 擦除元素
(公有成员函数) [编辑]
 交换内容
(公有成员函数) [编辑]
(C++17)
 从容器中提取节点
(公有成员函数) [编辑]
(C++17)
 从另一个容器中拼接节点
(公有成员函数) [编辑]
查找
 返回与特定键匹配的元素数量
(公有成员函数) [编辑]
 查找具有特定键的元素
(公有成员函数) [编辑]
(C++20)
 检查容器是否包含具有特定键的元素
(公有成员函数) [编辑]
 返回与特定键匹配的元素范围
(公有成员函数) [编辑]
桶接口
 返回指向指定桶开头的迭代器
(公有成员函数) [编辑]
 返回指向指定桶结尾的迭代器
(公有成员函数) [编辑]
 返回桶的数量
(公有成员函数) [编辑]
 返回桶的最大数量
(公有成员函数) [编辑]
 返回特定桶中的元素数量
(公有成员函数) [编辑]
 返回特定键的桶
(公有成员函数) [编辑]
哈希策略
 返回每个桶的平均元素数量
(公有成员函数) [编辑]
 管理每个桶的平均元素数量的最大值
(公有成员函数) [编辑]
 至少保留指定数量的桶并重新生成哈希表
(公有成员函数) [编辑]
 至少为指定数量的元素保留空间并重新生成哈希表
(公有成员函数) [编辑]
观察者
 返回用于对键进行哈希处理的函数
(公有成员函数) [编辑]
 返回用于比较键是否相等的函数
(公有成员函数) [编辑]

[编辑] 非成员函数

(C++11)(C++11)(C++20 中已移除)
 比较 unordered_multimap 中的值
(函数模板) [编辑]
(C++11)
 特化 std::swap 算法
(函数模板) [编辑]
(C++20)
 擦除所有满足特定条件的元素
(函数模板) [编辑]

推导指南

 (自 C++17)

[编辑] 注释

Feature-test 宏 值 Std 功能
__cpp_lib_containers_ranges 202202L (C++23) 容器的范围构造和插入

[编辑] 示例

本节不完整
原因: 无示例

[编辑] 缺陷报告

以下行为改变的缺陷报告被追溯应用到之前发布的 C++ 标准。

DR 应用于 已发布的行为 正确行为
LWG 2050 C++11 reference、const_reference、pointer
和 const_pointer 的定义基于 allocator_type		 基于 value_type 和
std::allocator_traits

[编辑] 参见

(C++11)
 键值对集合，按键哈希，键是唯一的
(类模板) [编辑]
 键值对集合，按键排序
(类模板) [编辑]
(C++23)
 调整两个容器以提供按键排序的键值对集合
(类模板) [编辑]
从 "https://cppreference.cn/mwiki/index.php?title=cpp/container/unordered_multimap&oldid=174048" 检索