Namespaces
Variants

std::flat_set<Key,Compare,KeyContainer>:: flat_set

From cppreference.net

flat_set ( )
: flat_set ( key_compare ( ) ) { }
(1) (自 C++23 起)
template < class Allocator >
flat_set ( const flat_set & other, const Allocator & alloc ) ;
(2) (自 C++23 起)
template < class Allocator >
flat_set ( flat_set && other, const Allocator & alloc ) ;
(3) (自 C++23 起)
explicit flat_set ( container_type cont,
const key_compare & comp = key_compare ( ) ) ;
(4) (自 C++23 起)
template < class Allocator >
flat_set ( const container_type & cont, const Allocator & alloc ) ;
(5) (自 C++23 起)
template < class Allocator >

flat_set ( const container_type & cont, const key_compare & comp,

const Allocator & alloc ) ;
(6) (自 C++23 起)
flat_set ( std:: sorted_unique_t s, container_type cont,

const key_compare & comp = key_compare ( ) )

: c ( std :: move ( cont ) ) , compare ( comp ) { }
(7) (自 C++23 起)
template < class Allocator >

flat_set ( std:: sorted_unique_t s, const container_type & cont,

const Allocator & alloc ) ;
(8) (自 C++23 起)
template < class Allocator >

flat_set ( std:: sorted_unique_t s, const container_type & cont,

const key_compare & comp, const Allocator & alloc ) ;
(9) (自 C++23 起)
explicit flat_set ( const key_compare & comp )
: c ( ) , compare ( comp ) { }
(10) (自 C++23 起)
template < class Allocator >
flat_set ( const key_compare & comp, const Allocator & alloc ) ;
(11) (自 C++23 起)
template < class Allocator >
explicit flat_set ( const Allocator & alloc ) ;
(12) (自 C++23 起)
template < class InputIter >

flat_set ( InputIter first, InputIter last,
const key_compare & comp = key_compare ( ) )

: c ( ) , compare ( comp ) ;
(13) (自 C++23 起)
template < class InputIter, class Allocator >

flat_set ( InputIter first, InputIter last,

const key_compare & comp, const Allocator & alloc ) ;
(14) (自 C++23 起)
template < class InputIter, class Allocator >
flat_set ( InputIter first, InputIter last, const Allocator & alloc ) ;
(15) (自 C++23 起)
template < container-compatible-range < value_type > R >

flat_set ( std:: from_range_t , R && rg, const key_compare & comp )

: flat_set ( comp ) ;
(16) (自 C++23 起)
template < container-compatible-range < value_type > R >

flat_set ( std:: from_range_t fr, R && rg )

: flat_set ( fr, std:: forward < R > ( rg ) , key_compare ( ) ) { }
(17) <span class="t

从多种数据源构造新的容器适配器,并可选择性地提供比较函数对象 comp 和/或分配器 alloc

1) 默认构造函数。构造一个空的容器适配器。
2) 复制构造函数 。使用 other. c 内容的副本构造 c ,并使用 other. compare 构造 compare 。 请参阅下方的 分配器使用说明
3) 一个 移动构造函数 。使用移动语义构造容器适配器,其内容来自 other 。 请参阅下方的 分配器使用说明
4) 使用容器 cont 的内容构造底层容器。首先,使用 std :: move ( cont ) 初始化 c ,并使用 comp 初始化 compare 。然后根据 comp c 进行排序。最后使元素唯一化,即从每组连续相等元素中删除除首个元素外的所有元素。
5) (4) 相同,等价于 flat_set ( cont ) ; 。 请参阅下方的 分配器使用说明
6) (4) ,等价于 flat_set ( cont, comp ) ; 。 详见下方 分配器使用说明
7) 使用其他容器 cont 的内容构造底层容器。使用 std :: move ( cont ) 初始化 c ,并使用 comp 初始化 compare
8) (7) 相同,等价于 flat_set ( s, cont ) ; 。 请参阅下方的 分配器使用说明
9) (7) ,等价于 flat_set ( s, cont, comp ) ; 。 请参阅下方的 分配器使用说明
10) 构造一个空的容器适配器。
11,12) 构造一个空的容器适配器。 详见下方的 分配器使用说明
13) 使用范围 [ first , last ) 的内容构造容器适配器,等价于 insert ( first, last ) ;
14,15) (13) 相同。 请参阅下方的 分配器使用说明
16) 使用范围 rg 的内容构造容器适配器。首先使用 (10) 作为 委托构造函数 ,然后通过 insert_range ( std:: forward < R > ( rg ) ) ; 的方式初始化 c
17) (16) 相同,但将其用作 委托构造函数
18,19) (16) 。 参见下方 分配器使用说明
20) 使用范围 [ first , last ) 的内容构造底层容器。使用 c ( first, last ) 初始化 c ,并使用 compare ( comp ) 初始化 compare
21,22) (20) 相同。 请参阅下方的 分配器使用说明
23) 一个 初始化列表构造函数 。使用初始化列表 init 的内容构造底层容器,通过 (13) 作为 委托构造函数
24,25) (23) 。 参见下方 分配器使用说明
26) 一个 初始化列表构造函数 。使用初始化列表 init 的内容构造底层容器,通过 (20) 作为 委托构造函数
27,28) 保存为 (26) 。 参见下方的 分配器使用说明

关于重载 (13-15,20-22) 的说明:如果 [ first , last ) 不是有效的 范围 ,则行为未定义。

关于重载 (4-6,13-19,23-25) 的说明:如果范围内存在多个键值比较等效的元素,则未指定插入哪个元素(待解决 LWG2844 )。

目录

分配器使用说明

构造函数 (2,3,5,6,8,9,11,12,14,15,17,19,21,22,24,25,27,28) 与对应的非分配器构造函数等效,区别在于 c 是通过 使用分配器构造 构建的。 这些重载仅在 std:: uses_allocator_v < container_type, Allocator > true 时参与重载决议。

参数

cont - 用作初始化底层容器来源的容器
other - 用作初始化底层容器元素来源的另一个 flat_set
alloc - 用于底层容器所有内存分配的分配器
comp - 用于所有键比较的函数对象
first, last - 定义要复制的元素来源 范围 的迭代器对
init - 用于初始化底层容器元素的初始化列表
rg - 用作初始化底层容器来源的 容器兼容范围 (即元素可转换为 value_type input_range
fr - 指示所含成员应进行范围构造的 消歧义标签
s - 指示输入序列相对于 compare 已排序且所有元素唯一的 消歧义标签
类型要求
-
InputIt 必须满足 LegacyInputIterator 的要求。
-
Compare 必须满足 Compare 的要求。
-
Allocator 必须满足 Allocator 的要求。

复杂度

1) 常数。
2) other 的大小成线性。
3) 与包装容器的对应移动构造函数相同,即常数或与 cont 的大小成线性。
4-6) cont 相对于 compare 已排序则为 N 的线性,否则为 𝓞(N·log(N)) ,其中 N 是此调用前 cont. size ( ) 的值。
7-9) 与包装容器的对应移动构造函数相同,即常数或与 cont 的大小成线性。
10-12) 常数。
13-15) 若输入范围 [ first , last ) 相对于 compare 已排序则为 N 的线性,否则为 𝓞(N·log(N)) ,其中 N 是此调用前 cont. size ( ) 的值。
16-19) 若输入范围 rg 相对于 compare 已排序则为 N 的线性,否则为 𝓞(N·log(N)) ,其中 N 是此调用前 cont. size ( ) 的值。
20-22) [ first , last ) 的大小成线性。
23-25) init 的元素相对于 compare 已排序则为 N 的线性,否则为 𝓞(N·log(N)) ,其中 N 是此调用前 cont. size ( ) 的值。
26-28) init 的大小成线性。

异常

Allocator::allocate 的调用可能抛出异常。

备注

容器移动构造(重载 ( 3 ) )后,对 other 的引用、指针和迭代器(除尾后迭代器外)保持有效,但引用的是现在位于 * this 中的元素。当前标准通过 [container.reqmts]/67 中的总括声明提供此保证,且正在通过 LWG issue 2321 考虑更直接的保证。

示例