std::set<Key,Compare,Allocator>:: insert_range
|
(C++17)
|
||||
| Sequence | ||||
|
(C++11)
|
||||
|
(C++26)
|
||||
|
(C++26)
|
||||
|
(C++11)
|
||||
| Associative | ||||
| Unordered associative | ||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
| Adaptors | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
| Views | ||||
|
(C++20)
|
||||
|
(C++23)
|
||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
| Member functions | |||||||||||||||||||||||||||
| Non-member functions | |||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||
| Deduction guides (C++17) | |||||||||||||||||||||||||||
|
template
<
container-compatible-range
<
value_type
>
R
>
void insert_range ( R && rg ) ; |
(C++23 起)
(C++26 起为 constexpr) |
|
当且仅当在 * this 中不存在与指定范围内元素键值相等的元素时,插入该范围内每个元素的副本。
范围内的每个迭代器 rg 都会被精确解引用一次。
若满足以下任一条件,则行为未定义:
-
value_type无法从 * ranges:: begin ( rg ) 通过置入构造方式进入set - rg 与 * this 存在重叠区域
不会使任何迭代器或引用失效。
目录 |
参数
| rg | - |
一个
容器兼容范围
,即其元素可转换为
T
的
input_range
|
复杂度
\(\scriptsize N \cdot \log(S + N)\) N·log(S+N) ,其中 \(\scriptsize S\) S 表示 size ( ) , \(\scriptsize N\) N 表示 ranges:: distance ( rg ) 。
注释
| 功能测试 宏 | 值 | 标准 | 功能 |
|---|---|---|---|
__cpp_lib_containers_ranges
|
202202L
|
(C++23) | 支持范围 的构造与插入操作 |
示例
#include <iostream> #include <set> void println(auto, const auto& container) { for (const auto& elem : container) std::cout << elem << ' '; std::cout << '\n'; } int main() { auto container = std::set{1, 3, 2, 4}; const auto rg = {-1, 3, -2}; #ifdef __cpp_lib_containers_ranges container.insert_range(rg); #else container.insert(rg.begin(), rg.end()); #endif println("{}", container); }
输出:
-2 -1 1 2 3 4
另请参阅
|
插入元素
或节点
(C++17 起)
(公开成员函数) |