定义于头文件 <unordered_set>
template< class Key, | (1) | (C++11 起) |
namespace pmr { template <class Key, | (2) | (C++17 起) |
unordered_set is 是含有 Key 类型唯一对象集合的关联容器。搜索、插入和移除拥有平均常数时间复杂度。
在内部,元素并不以任何特别顺序排序,而是组织进桶中。元素被放进哪个桶完全依赖其值的哈希。这允许对单独元素的快速访问,因为哈希一旦,就准确指代元素被放入的桶。
不可修改容器元素(即使通过非 const 迭代器),因为修改可能更改元素的哈希,并破坏容器。
std::unordered_set
满足容器 (Container) 、具分配器容器 (AllocatorAwareContainer) 、无序关联容器 (UnorderedAssociativeContainer) 的要求。
成员函数
(构造函数) | 构造 unordered_set (公开成员函数) |
(析构函数) | 析构 unordered_set (公开成员函数) |
operator= | 赋值给容器 (公开成员函数) |
get_allocator | 返回相关的分配器 (公开成员函数) |
迭代器 | |
begin cbegin | 返回指向容器第一个元素的迭代器 (公开成员函数) |
end cend | 返回指向容器尾端的迭代器 (公开成员函数) |
容量
empty | 检查容器是否为空 (公开成员函数) |
size | 返回容纳的元素数 (公开成员函数) |
max_size | 返回可容纳的最大元素数 (公开成员函数) |
修改器
clear | 清除内容 (公开成员函数) |
insert | 插入元素或结点 (C++17 起) (公开成员函数) |
emplace | 原位构造元素 (公开成员函数) |
emplace_hint | 使用提示原位构造元素 (公开成员函数) |
erase | 擦除元素 (公开成员函数) |
swap | 交换内容 (公开成员函数) |
extract (C++17) | 从另一容器释出结点 (公开成员函数) |
merge (C++17) | 从另一容器接合结点 (公开成员函数) |
查找
count | 返回匹配特定键的元素数量 (公开成员函数) |
find | 寻找带有特定键的元素 (公开成员函数) |
contains (C++20) | 检查容器是否含有带特定关键的元素 (公开成员函数) |
equal_range | 返回匹配特定键的元素范围 (公开成员函数) |
桶接口
begin(size_type) cbegin(size_type) | 返回一个迭代器,指向指定的桶的开始 (公开成员函数) |
end(size_type) cend(size_type) | 返回一个迭代器,指向指定的桶的末尾 (公开成员函数) |
bucket_count | 返回桶数 (公开成员函数) |
max_bucket_count | 返回桶的最大数量 (公开成员函数) |
bucket_size | 返回在特定的桶中的元素数量 (公开成员函数) |
bucket | 返回带有特定键的桶 (公开成员函数) |
哈希策略
load_factor | 返回每个桶的平均元素数量 (公开成员函数) |
max_load_factor | 管理每个桶的平均元素数量的最大值 (公开成员函数) |
rehash | 为至少为指定数量的桶预留存储空间。 这会重新生成哈希表。 (公开成员函数) |
reserve | 为至少为指定数量的元素预留存储空间。 这会重新生成哈希表。 (公开成员函数) |
观察器
hash_function | 返回用于对关键哈希的函数 (公开成员函数) |
key_eq | 返回用于比较键的相等性的函数 (公开成员函数) |
非成员函数
operator==operator!= | 比较 unordered_set 中的值 (函数模板) |
std::swap(std::unordered_set) (C++11) | 特化 std::swap 算法 (函数模板) |
erase_if(std::unordered_set) (C++20) | 擦除所有满足特定判别标准的元素 (函数模板) |
推导指引(C++17 起)
注意
成员类型 iterator
与 const_iterator
可能是同一类型的别名。这表明以二个类型为参数类型的一对函数重载可能违背单一定义规则。因为 iterator
可转换为 const_iterator
,单个以 const_iterator
为参数类型的函数会是有效的。