无序映射容器更多...

#include <unordered_map.hpp>

Public 类型
using	key_type = typename base_type::key_type
	键类型
using	value_type = typename base_type::value_type
	值类型
using	hasher = typename base_type::hasher
	哈希函数类型
using	key_equal = typename base_type::key_equal
	键相等比较函数类型
using	size_type = typename base_type::size_type
	大小类型
using	difference_type = typename base_type::difference_type
	差值类型
using	pointer = typename base_type::pointer
	指针类型
using	const_pointer = typename base_type::const_pointer
	常量指针类型
using	reference = typename base_type::reference
	引用类型
using	const_reference = typename base_type::const_reference
	常量引用类型
using	iterator = typename base_type::iterator
	迭代器类型
using	const_iterator = typename base_type::const_iterator
	常量迭代器类型
using	allocator_type = typename base_type::allocator_type
	分配器类型

Public 成员函数
	unordered_map ()=default
	默认构造函数
	unordered_map (size_type n)
	构造函数，指定初始桶数
	unordered_map (size_type n, const hasher &hf)
	构造函数，指定初始桶数和哈希函数
	unordered_map (size_type n, const hasher &hf, const key_equal &eql)
	构造函数，指定初始桶数、哈希函数和键相等比较函数
	unordered_map (const unordered_map &other)
	拷贝构造函数
unordered_map &	operator= (const unordered_map &other)
	拷贝赋值运算符
	unordered_map (unordered_map &&other) noexcept(is_nothrow_move_constructible_v< base_type >)
	移动构造函数
unordered_map &	operator= (unordered_map &&other) noexcept(is_nothrow_move_assignable_v< base_type >)
	移动赋值运算符
template<typename Iterator>
	unordered_map (Iterator first, Iterator last)
	范围构造函数
template<typename Iterator>
	unordered_map (Iterator first, Iterator list, size_type n)
	范围构造函数，指定初始桶数
template<typename Iterator>
	unordered_map (Iterator first, Iterator last, size_type n, const hasher &hf)
	范围构造函数，指定初始桶数和哈希函数
template<typename Iterator>
	unordered_map (Iterator first, Iterator last, size_type n, const hasher &hf, const key_equal &eql)
	范围构造函数，指定初始桶数、哈希函数和键相等比较函数
	unordered_map (std::initializer_list< value_type > ilist)
	初始化列表构造函数
	unordered_map (std::initializer_list< value_type > ilist, size_type n)
	初始化列表构造函数，指定初始桶数
	unordered_map (std::initializer_list< value_type > ilist, size_type n, const hasher &hf)
	初始化列表构造函数，指定初始桶数和哈希函数
	unordered_map (std::initializer_list< value_type > ilist, size_type n, const hasher &hf, const key_equal &eql)
	初始化列表构造函数，指定初始桶数、哈希函数和键相等比较函数
NEFORCE_NODISCARD iterator	begin () noexcept
	获取起始迭代器
NEFORCE_NODISCARD iterator	end () noexcept
	获取结束迭代器
NEFORCE_NODISCARD const_iterator	begin () const noexcept
	获取常量起始迭代器
NEFORCE_NODISCARD const_iterator	end () const noexcept
	获取常量结束迭代器
NEFORCE_NODISCARD const_iterator	cbegin () const noexcept
	获取常量起始迭代器
NEFORCE_NODISCARD const_iterator	cend () const noexcept
	获取常量结束迭代器
NEFORCE_NODISCARD size_type	size () const noexcept
	获取元素数量
NEFORCE_NODISCARD size_type	max_size () const noexcept
	获取最大可能大小
NEFORCE_NODISCARD bool	empty () const noexcept
	检查是否为空
NEFORCE_NODISCARD size_type	count (const key_type &key) const noexcept(noexcept(ht_.count(key)))
	统计具有指定键的元素数量
NEFORCE_NODISCARD size_type	buckets_size () const noexcept
	获取桶数量
NEFORCE_NODISCARD size_type	buckets_max_count () const noexcept
	获取最大桶数量
NEFORCE_NODISCARD size_type	bucket_size (size_type n) const noexcept
	获取指定桶的大小
NEFORCE_NODISCARD hasher	hash_func () const noexcept(noexcept(ht_.hash_func()))
	获取哈希函数对象
NEFORCE_NODISCARD key_equal	key_eql () const noexcept(noexcept(ht_.key_eql()))
	获取键相等比较函数对象
NEFORCE_NODISCARD float	load_factor () const noexcept
	获取当前负载因子
NEFORCE_NODISCARD float	max_load_factor () const noexcept
	获取最大负载因子
void	max_load_factor (float lf) noexcept
	设置最大负载因子
void	rehash (size_type n)
	重新哈希，调整桶数量
void	reserve (size_type n)
	预留空间
template<typename... Args>
pair< iterator, bool >	emplace (Args &&... args)
	在unordered_map中就地构造元素
pair< iterator, bool >	insert (const value_type &value)
	插入元素（拷贝版本）
pair< iterator, bool >	insert (value_type &&value)
	移动插入元素
template<typename Iterator>
void	insert (Iterator first, Iterator last)
	范围插入元素
size_type	erase (const key_type &key) noexcept
	删除所有具有指定键的元素
iterator	erase (iterator position) noexcept
	删除指定位置的元素
iterator	erase (iterator first, iterator last) noexcept
	删除指定范围内的元素
const_iterator	erase (const_iterator position) noexcept
	删除指定位置的常量元素
const_iterator	erase (const_iterator first, const_iterator last) noexcept
	删除指定范围内的常量元素
void	clear () noexcept
	清空unordered_map
NEFORCE_NODISCARD iterator	find (const key_type &key)
	查找具有指定键的元素
NEFORCE_NODISCARD const_iterator	find (const key_type &key) const
	查找具有指定键的常量元素
NEFORCE_NODISCARD pair< iterator, iterator >	equal_range (const key_type &key)
	获取等于指定键的元素范围
NEFORCE_NODISCARD pair< const_iterator, const_iterator >	equal_range (const key_type &key) const
	获取等于指定键的常量元素范围
NEFORCE_NODISCARD T &	operator[] (const key_type &key)
	下标访问操作符
NEFORCE_NODISCARD const T &	at (const key_type &key) const
	带边界检查的常量访问
NEFORCE_NODISCARD T &	at (const key_type &key)
	带边界检查的访问
void	swap (unordered_map &other) noexcept(is_nothrow_swappable_v< base_type >)
	交换两个unordered_map的内容
NEFORCE_NODISCARD bool	operator== (const unordered_map &rhs) const noexcept(noexcept(ht_==rhs.ht_))
	相等比较操作符
NEFORCE_NODISCARD bool	operator< (const unordered_map &rhs) const noexcept(noexcept(ht_< rhs.ht_))
	小于比较操作符

详细描述

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>
class unordered_map< Key, T, HashFcn, EqualKey, Alloc >

无序映射容器

模板参数

Key	键类型
T	值类型
HashFcn	哈希函数类型，默认为hash<Key>
EqualKey	键相等比较函数类型，默认为equal_to<Key>
Alloc	分配器类型

unordered_map是一种关联容器，存储键值对（key-value pairs），每个键在容器中唯一。元素无序存储，由哈希函数将键映射到桶中。支持快速的键查找。底层使用哈希表实现。

在文件 unordered_map.hpp 第 38 行定义.

构造及析构函数说明

◆ unordered_map() [1/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map ( )

default

默认构造函数

构造一个空unordered_map。

被这些函数引用 operator<(), operator=(), operator=(), operator==(), swap(), unordered_map(), unordered_map(), unordered_map(), unordered_map(), unordered_map() , 以及 unordered_map().

◆ unordered_map() [2/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map ( size_type n )

inlineexplicit

构造函数，指定初始桶数

参数

n 初始桶数

在文件 unordered_map.hpp 第 79 行定义.

◆ unordered_map() [3/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	size_type	n,
		const hasher &	hf )

inline

构造函数，指定初始桶数和哈希函数

参数

n	初始桶数
hf	哈希函数

在文件 unordered_map.hpp 第 87 行定义.

◆ unordered_map() [4/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	size_type	n,
		const hasher &	hf,
		const key_equal &	eql )

inline

构造函数，指定初始桶数、哈希函数和键相等比较函数

参数

n	初始桶数
hf	哈希函数
eql	键相等比较函数

在文件 unordered_map.hpp 第 96 行定义.

◆ unordered_map() [5/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map ( const unordered_map< Key, T, HashFcn, EqualKey, Alloc > & other )

inline

拷贝构造函数

参数

other 源unordered_map

在文件 unordered_map.hpp 第 103 行定义.

引用了 unordered_map().

◆ unordered_map() [6/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map ( unordered_map< Key, T, HashFcn, EqualKey, Alloc > && other )

inlinenoexcept

移动构造函数

参数

other 源unordered_map

在文件 unordered_map.hpp 第 120 行定义.

引用了 is_nothrow_move_constructible_v, move() , 以及 unordered_map().

◆ unordered_map() [7/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

template<typename Iterator>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	Iterator	first,
		Iterator	last )

inline

范围构造函数

模板参数

Iterator 迭代器类型

参数

first	起始迭代器
last	结束迭代器

在文件 unordered_map.hpp 第 140 行定义.

◆ unordered_map() [8/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

template<typename Iterator>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	Iterator	first,
		Iterator	list,
		size_type	n )

inline

范围构造函数，指定初始桶数

模板参数

Iterator 迭代器类型

参数

first	起始迭代器
list	结束迭代器
n	初始桶数

在文件 unordered_map.hpp 第 153 行定义.

◆ unordered_map() [9/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

template<typename Iterator>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	Iterator	first,
		Iterator	last,
		size_type	n,
		const hasher &	hf )

inline

范围构造函数，指定初始桶数和哈希函数

模板参数

Iterator 迭代器类型

参数

first	起始迭代器
last	结束迭代器
n	初始桶数
hf	哈希函数

在文件 unordered_map.hpp 第 167 行定义.

◆ unordered_map() [10/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

template<typename Iterator>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	Iterator	first,
		Iterator	last,
		size_type	n,
		const hasher &	hf,
		const key_equal &	eql )

inline

范围构造函数，指定初始桶数、哈希函数和键相等比较函数

模板参数

Iterator 迭代器类型

参数

first	起始迭代器
last	结束迭代器
n	初始桶数
hf	哈希函数
eql	键相等比较函数

在文件 unordered_map.hpp 第 182 行定义.

◆ unordered_map() [11/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map ( std::initializer_list< value_type > ilist )

inline

初始化列表构造函数

参数

ilist 初始化列表

在文件 unordered_map.hpp 第 191 行定义.

引用了 begin(), end() , 以及 unordered_map().

◆ unordered_map() [12/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	std::initializer_list< value_type >	ilist,
		size_type	n )

inline

初始化列表构造函数，指定初始桶数

参数

ilist	初始化列表
n	初始桶数

在文件 unordered_map.hpp 第 199 行定义.

引用了 begin(), end() , 以及 unordered_map().

◆ unordered_map() [13/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	std::initializer_list< value_type >	ilist,
		size_type	n,
		const hasher &	hf )

inline

初始化列表构造函数，指定初始桶数和哈希函数

参数

ilist	初始化列表
n	初始桶数
hf	哈希函数

在文件 unordered_map.hpp 第 208 行定义.

引用了 begin(), end() , 以及 unordered_map().

◆ unordered_map() [14/14]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map< Key, T, HashFcn, EqualKey, Alloc >::unordered_map	(	std::initializer_list< value_type >	ilist,
		size_type	n,
		const hasher &	hf,
		const key_equal &	eql )

inline

初始化列表构造函数，指定初始桶数、哈希函数和键相等比较函数

参数

ilist	初始化列表
n	初始桶数
hf	哈希函数
eql	键相等比较函数

在文件 unordered_map.hpp 第 218 行定义.

引用了 begin(), end() , 以及 unordered_map().

成员函数说明

◆ at() [1/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD T & unordered_map< Key, T, HashFcn, EqualKey, Alloc >::at ( const key_type & key )

inline

带边界检查的访问

参数

key 要访问的键

返回: 对应键的值的引用

异常

iterator_exception 如果键不存在

在文件 unordered_map.hpp 第 490 行定义.

引用了 end().

◆ at() [2/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD const T & unordered_map< Key, T, HashFcn, EqualKey, Alloc >::at ( const key_type & key ) const

inline

带边界检查的常量访问

参数

key 要访问的键

返回: 对应键的值的常量引用

异常

iterator_exception 如果键不存在

在文件 unordered_map.hpp 第 476 行定义.

引用了 end().

◆ begin() [1/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD const_iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::begin ( ) const

inlinenoexcept

获取常量起始迭代器

返回: 指向第一个元素的常量迭代器

在文件 unordered_map.hpp 第 237 行定义.

◆ begin() [2/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::begin ( )

inlinenoexcept

获取起始迭代器

返回: 指向第一个元素的迭代器

在文件 unordered_map.hpp 第 225 行定义.

被这些函数引用 unordered_map(), unordered_map(), unordered_map() , 以及 unordered_map().

◆ bucket_size()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD size_type unordered_map< Key, T, HashFcn, EqualKey, Alloc >::bucket_size ( size_type n ) const

inlinenoexcept

获取指定桶的大小

参数

n 桶索引

返回: 桶中的元素数量

在文件 unordered_map.hpp 第 301 行定义.

◆ buckets_max_count()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD size_type unordered_map< Key, T, HashFcn, EqualKey, Alloc >::buckets_max_count ( ) const

inlinenoexcept

获取最大桶数量

返回: 最大桶数量

在文件 unordered_map.hpp 第 294 行定义.

◆ buckets_size()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD size_type unordered_map< Key, T, HashFcn, EqualKey, Alloc >::buckets_size ( ) const

inlinenoexcept

获取桶数量

返回: 桶数量

在文件 unordered_map.hpp 第 288 行定义.

◆ cbegin()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD const_iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::cbegin ( ) const

inlinenoexcept

获取常量起始迭代器

返回: 指向第一个元素的常量迭代器

在文件 unordered_map.hpp 第 249 行定义.

◆ cend()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD const_iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::cend ( ) const

inlinenoexcept

获取常量结束迭代器

返回: 指向最后一个元素之后位置的常量迭代器

在文件 unordered_map.hpp 第 255 行定义.

◆ count()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD size_type unordered_map< Key, T, HashFcn, EqualKey, Alloc >::count ( const key_type & key ) const

inlinenoexcept

统计具有指定键的元素数量

参数

key 要统计的键

返回: 匹配的元素数量（0或1，因为键唯一）

在文件 unordered_map.hpp 第 280 行定义.

◆ emplace()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

template<typename... Args>

pair< iterator, bool > unordered_map< Key, T, HashFcn, EqualKey, Alloc >::emplace ( Args &&... args )

inline

在unordered_map中就地构造元素

模板参数

Args 构造参数类型

参数

args 构造参数

返回: 插入结果（迭代器和是否成功）

在文件 unordered_map.hpp 第 354 行定义.

引用了 forward().

被这些函数引用 get_current_task_group().

◆ empty()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD bool unordered_map< Key, T, HashFcn, EqualKey, Alloc >::empty ( ) const

inlinenoexcept

检查是否为空

返回: 是否为空

在文件 unordered_map.hpp 第 273 行定义.

◆ end() [1/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD const_iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::end ( ) const

inlinenoexcept

获取常量结束迭代器

返回: 指向最后一个元素之后位置的常量迭代器

在文件 unordered_map.hpp 第 243 行定义.

◆ end() [2/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::end ( )

inlinenoexcept

获取结束迭代器

返回: 指向最后一个元素之后位置的迭代器

在文件 unordered_map.hpp 第 231 行定义.

被这些函数引用 at(), at(), unordered_map(), unordered_map(), unordered_map() , 以及 unordered_map().

◆ equal_range() [1/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD pair< iterator, iterator > unordered_map< Key, T, HashFcn, EqualKey, Alloc >::equal_range ( const key_type & key )

inline

获取等于指定键的元素范围

参数

key 键值

返回: 包含范围起始和结束的pair

在文件 unordered_map.hpp 第 444 行定义.

◆ equal_range() [2/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD pair< const_iterator, const_iterator > unordered_map< Key, T, HashFcn, EqualKey, Alloc >::equal_range ( const key_type & key ) const

inline

获取等于指定键的常量元素范围

参数

key 键值

返回: 包含范围起始和结束的pair

在文件 unordered_map.hpp 第 451 行定义.

◆ erase() [1/5]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

size_type unordered_map< Key, T, HashFcn, EqualKey, Alloc >::erase ( const key_type & key )

inlinenoexcept

删除所有具有指定键的元素

参数

key 要删除的键

返回: 删除的元素数量

在文件 unordered_map.hpp 第 388 行定义.

◆ erase() [2/5]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

const_iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::erase	(	const_iterator	first,
		const_iterator	last )

inlinenoexcept

删除指定范围内的常量元素

参数

first	起始迭代器
last	结束迭代器

返回: 指向最后一个被删除元素之后位置的常量迭代器

在文件 unordered_map.hpp 第 418 行定义.

◆ erase() [3/5]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

const_iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::erase ( const_iterator position )

inlinenoexcept

删除指定位置的常量元素

参数

position 要删除的位置

返回: 指向被删除元素之后位置的常量迭代器

在文件 unordered_map.hpp 第 410 行定义.

◆ erase() [4/5]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::erase	(	iterator	first,
		iterator	last )

inlinenoexcept

删除指定范围内的元素

参数

first	起始迭代器
last	结束迭代器

返回: 指向最后一个被删除元素之后位置的迭代器

在文件 unordered_map.hpp 第 403 行定义.

◆ erase() [5/5]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::erase ( iterator position )

inlinenoexcept

删除指定位置的元素

参数

position 要删除的位置

返回: 指向被删除元素之后位置的迭代器

在文件 unordered_map.hpp 第 395 行定义.

◆ find() [1/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::find ( const key_type & key )

inline

查找具有指定键的元素

参数

key 要查找的键

返回: 指向第一个匹配元素的迭代器，未找到则返回end()

在文件 unordered_map.hpp 第 430 行定义.

◆ find() [2/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD const_iterator unordered_map< Key, T, HashFcn, EqualKey, Alloc >::find ( const key_type & key ) const

inline

查找具有指定键的常量元素

参数

key 要查找的键

返回: 指向第一个匹配元素的常量迭代器，未找到则返回cend()

在文件 unordered_map.hpp 第 437 行定义.

◆ hash_func()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD hasher unordered_map< Key, T, HashFcn, EqualKey, Alloc >::hash_func ( ) const

inlinenoexcept

获取哈希函数对象

返回: 哈希函数对象的副本

在文件 unordered_map.hpp 第 307 行定义.

引用了 hash_func().

被这些函数引用 hash_func().

◆ insert() [1/3]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

pair< iterator, bool > unordered_map< Key, T, HashFcn, EqualKey, Alloc >::insert ( const value_type & value )

inline

插入元素（拷贝版本）

参数

value 要插入的值

返回: 插入结果（迭代器和是否成功）

在文件 unordered_map.hpp 第 363 行定义.

◆ insert() [2/3]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

template<typename Iterator>

void unordered_map< Key, T, HashFcn, EqualKey, Alloc >::insert	(	Iterator	first,
		Iterator	last )

inline

范围插入元素

模板参数

Iterator 迭代器类型

参数

first	起始迭代器
last	结束迭代器

在文件 unordered_map.hpp 第 379 行定义.

◆ insert() [3/3]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

pair< iterator, bool > unordered_map< Key, T, HashFcn, EqualKey, Alloc >::insert ( value_type && value )

inline

移动插入元素

参数

value 要插入的值

返回: 插入结果（迭代器和是否成功）

在文件 unordered_map.hpp 第 370 行定义.

引用了 forward().

◆ key_eql()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD key_equal unordered_map< Key, T, HashFcn, EqualKey, Alloc >::key_eql ( ) const

inlinenoexcept

获取键相等比较函数对象

返回: 键相等比较函数对象的副本

在文件 unordered_map.hpp 第 313 行定义.

引用了 key_eql().

被这些函数引用 key_eql().

◆ load_factor()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD float unordered_map< Key, T, HashFcn, EqualKey, Alloc >::load_factor ( ) const

inlinenoexcept

获取当前负载因子

返回: 负载因子（元素数量/桶数量）

在文件 unordered_map.hpp 第 319 行定义.

◆ max_load_factor() [1/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD float unordered_map< Key, T, HashFcn, EqualKey, Alloc >::max_load_factor ( ) const

inlinenoexcept

获取最大负载因子

返回: 最大负载因子

在文件 unordered_map.hpp 第 325 行定义.

◆ max_load_factor() [2/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

void unordered_map< Key, T, HashFcn, EqualKey, Alloc >::max_load_factor ( float lf )

inlinenoexcept

设置最大负载因子

参数

lf 新的最大负载因子

在文件 unordered_map.hpp 第 331 行定义.

◆ max_size()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD size_type unordered_map< Key, T, HashFcn, EqualKey, Alloc >::max_size ( ) const

inlinenoexcept

获取最大可能大小

返回: 最大元素数量

在文件 unordered_map.hpp 第 267 行定义.

◆ operator<()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD bool unordered_map< Key, T, HashFcn, EqualKey, Alloc >::operator< ( const unordered_map< Key, T, HashFcn, EqualKey, Alloc > & rhs ) const

inlinenoexcept

小于比较操作符

参数

rhs	右侧unordered_map

返回: 按字典序比较结果

在文件 unordered_map.hpp 第 518 行定义.

引用了 unordered_map().

◆ operator=() [1/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map & unordered_map< Key, T, HashFcn, EqualKey, Alloc >::operator= ( const unordered_map< Key, T, HashFcn, EqualKey, Alloc > & other )

inline

拷贝赋值运算符

参数

other 源unordered_map

返回: 自身引用

在文件 unordered_map.hpp 第 111 行定义.

引用了 unordered_map().

◆ operator=() [2/2]

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

unordered_map & unordered_map< Key, T, HashFcn, EqualKey, Alloc >::operator= ( unordered_map< Key, T, HashFcn, EqualKey, Alloc > && other )

inlinenoexcept

移动赋值运算符

参数

other 源unordered_map

返回: 自身引用

在文件 unordered_map.hpp 第 128 行定义.

引用了 is_nothrow_move_assignable_v, move() , 以及 unordered_map().

◆ operator==()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD bool unordered_map< Key, T, HashFcn, EqualKey, Alloc >::operator== ( const unordered_map< Key, T, HashFcn, EqualKey, Alloc > & rhs ) const

inlinenoexcept

相等比较操作符

参数

rhs	右侧unordered_map

返回: 如果两个unordered_map大小相等且对应元素相等返回true

在文件 unordered_map.hpp 第 509 行定义.

引用了 unordered_map().

◆ operator[]()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD T & unordered_map< Key, T, HashFcn, EqualKey, Alloc >::operator[] ( const key_type & key )

inline

下标访问操作符

参数

key 要访问的键

返回: 对应键的值的引用

如果键不存在，则插入一个默认构造的值并返回其引用。

在文件 unordered_map.hpp 第 462 行定义.

◆ rehash()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

void unordered_map< Key, T, HashFcn, EqualKey, Alloc >::rehash ( size_type n )

inline

重新哈希，调整桶数量

参数

n 目标桶数量

在文件 unordered_map.hpp 第 337 行定义.

◆ reserve()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

void unordered_map< Key, T, HashFcn, EqualKey, Alloc >::reserve ( size_type n )

inline

预留空间

参数

n 期望的元素数量

确保unordered_map至少能容纳n个元素而不触发rehash。

在文件 unordered_map.hpp 第 345 行定义.

◆ size()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

NEFORCE_NODISCARD size_type unordered_map< Key, T, HashFcn, EqualKey, Alloc >::size ( ) const

inlinenoexcept

获取元素数量

返回: unordered_map中的元素数量

在文件 unordered_map.hpp 第 261 行定义.

被这些函数引用 get_current_task_group().

◆ swap()

template<typename Key, typename T, typename HashFcn = hash<Key>, typename EqualKey = equal_to<Key>, typename Alloc = allocator<hashtable_node<pair<const Key, T>>>>

void unordered_map< Key, T, HashFcn, EqualKey, Alloc >::swap ( unordered_map< Key, T, HashFcn, EqualKey, Alloc > & other )

inlinenoexcept

交换两个unordered_map的内容

参数

other 要交换的另一个unordered_map

在文件 unordered_map.hpp 第 502 行定义.

引用了 is_nothrow_swappable_v , 以及 unordered_map().

该类的文档由以下文件生成:

unordered_map.hpp

Public 类型

Public 成员函数

详细描述

构造及析构函数说明

◆ unordered_map() [1/14]

◆ unordered_map() [2/14]

◆ unordered_map() [3/14]

◆ unordered_map() [4/14]

◆ unordered_map() [5/14]

◆ unordered_map() [6/14]

◆ unordered_map() [7/14]

◆ unordered_map() [8/14]

◆ unordered_map() [9/14]

◆ unordered_map() [10/14]

◆ unordered_map() [11/14]

◆ unordered_map() [12/14]

◆ unordered_map() [13/14]

◆ unordered_map() [14/14]

成员函数说明

◆ at() [1/2]

◆ at() [2/2]

◆ begin() [1/2]

◆ begin() [2/2]

◆ bucket_size()

◆ buckets_max_count()

◆ buckets_size()

◆ cbegin()

◆ cend()

◆ count()

◆ emplace()

◆ empty()

◆ end() [1/2]

◆ end() [2/2]

◆ equal_range() [1/2]

◆ equal_range() [2/2]

◆ erase() [1/5]

◆ erase() [2/5]

◆ erase() [3/5]

◆ erase() [4/5]

◆ erase() [5/5]

◆ find() [1/2]

◆ find() [2/2]

◆ hash_func()

◆ insert() [1/3]

◆ insert() [2/3]

◆ insert() [3/3]

◆ key_eql()

◆ load_factor()

◆ max_load_factor() [1/2]

◆ max_load_factor() [2/2]

◆ max_size()

◆ operator<()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ operator[]()

◆ rehash()

◆ reserve()

◆ size()

◆ swap()