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

[编辑] 成员函数

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

[编辑] 非成员函数

比较 unordered_set 中的值
(函数模板) [编辑]
特化 std::swap 算法
(函数模板) [编辑]

[编辑] 推导指引(C++17 起)

[编辑] 注意

成员类型 iteratorconst_iterator 可以是同一类型的别名。因为 iterator 可转化为 const_iterator ,应当在函数声明参数列表中使用 const_iterator 以避免违背一个定义规则( ODR )。