std::unordered_set

来自cppreference.com
< cpp‎ | container
 
 
 
 
定义于头文件 <unordered_set>
template<

    class Key,
    class Hash = std::hash<Key>,
    class KeyEqual = std::equal_to<Key>,
    class Allocator = std::allocator<Key>

> class unordered_set;
(1) (C++11 起)
namespace pmr {

    template <class Key,
              class Hash = std::hash<Key>,
              class Pred = std::equal_to<Key>>
    using unordered_set = std::unordered_set<Key, Hash, Pred,
                                             std::pmr::polymorphic_allocator<Key>>;

}
(2) (C++17 起)

unordered_set is 是含有 Key 类型唯一对象集合的关联容器。搜索、插入和移除拥有平均常数时间复杂度。

在内部,元素并不以任何特别顺序排序,而是组织进桶中。元素被放进哪个桶完全依赖其值的哈希。这允许对单独元素的快速访问,因为哈希一旦,就准确指代元素被放入的桶。

不可修改容器元素(即使通过非 const 迭代器),因为修改可能更改元素的哈希,并破坏容器。

std::unordered_set 满足容器 (Container) 具分配器容器 (AllocatorAwareContainer) 无序关联容器 (UnorderedAssociativeContainer) 的要求。

成员类型

 
成员类型 定义
key_type Key
value_type Key
size_type 无符号整数类型(通常是 std::size_t
difference_type 有符号整数类型(通常是 std::ptrdiff_t
hasher Hash
key_equal

KeyEqual

(C++20 前)

Hash::transparent_key_equal ,若定义且它指名类型,否则为 KeyEqual

(C++20 起)

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)
const_iterator 常向前迭代器
local_iterator 类别、值、差、指针和引用类型都与 iterator 相同的迭代器类型。
能用此迭代器在单个桶迭代,但不能跨桶。
const_local_iterator 类别、值、差、指针和引用类型都与 const_iterator 相同的迭代器类型。
能用此迭代器在单个桶迭代,但不能跨桶。
node_type(C++17 起) 表示容器结点的结点把柄特化
insert_return_type(C++17 起) 描述插入 node_type 结果的类型,下列类型的特化
template <class Iter, class NodeType> struct /*unspecified*/ {
    Iter     position;
    bool     inserted;
    NodeType node;
};
,以模板实参 iteratornode_type 实例化。

成员函数

构造 unordered_set
(公开成员函数)
析构 unordered_set
(公开成员函数)
赋值给容器
(公开成员函数)
返回相关的分配器
(公开成员函数)
迭代器
返回指向容器第一个元素的迭代器
(公开成员函数)
返回指向容器尾端的迭代器
(公开成员函数)
容量
检查容器是否为空
(公开成员函数)
返回容纳的元素数
(公开成员函数)
返回可容纳的最大元素数
(公开成员函数)
修改器
清除内容
(公开成员函数)
插入元素或结点 (C++17 起)
(公开成员函数)
原位构造元素
(公开成员函数)
使用提示原位构造元素
(公开成员函数)
擦除元素
(公开成员函数)
交换内容
(公开成员函数)
(C++17)
从另一容器释出结点
(公开成员函数)
(C++17)
从另一容器接合结点
(公开成员函数)
查找
返回匹配特定键的元素数量
(公开成员函数)
寻找带有特定键的元素
(公开成员函数)
(C++20)
检查容器是否含有带特定关键的元素
(公开成员函数)
返回匹配特定键的元素范围
(公开成员函数)
桶接口
返回一个迭代器,指向指定的桶的开始
(公开成员函数)
返回一个迭代器,指向指定的桶的末尾
(公开成员函数)
返回桶数
(公开成员函数)
返回桶的最大数量
(公开成员函数)
返回在特定的桶中的元素数量
(公开成员函数)
返回带有特定键的桶
(公开成员函数)
哈希策略
返回每个桶的平均元素数量
(公开成员函数)
管理每个桶的平均元素数量的最大值
(公开成员函数)
为至少为指定数量的桶预留存储空间。
这会重新生成哈希表。
(公开成员函数)
为至少为指定数量的元素预留存储空间。
这会重新生成哈希表。
(公开成员函数)
观察器
返回用于对关键哈希的函数
(公开成员函数)
返回用于比较键的相等性的函数
(公开成员函数)

非成员函数

比较 unordered_set 中的值
(函数模板)
特化 std::swap 算法
(函数模板)
擦除所有满足特定判别标准的元素
(函数模板)

推导指引(C++17 起)

注意

成员类型 iteratorconst_iterator 可能是同一类型的别名。这表明以二个类型为参数类型的一对函数重载可能违背单一定义规则。因为 iterator 可转换为 const_iterator ,单个以 const_iterator 为参数类型的函数会是有效的。