std::flat_multiset<Key,Compare,KeyContainer>:: insert_range
|
template
<
container-compatible-range
<
value_type
>
R
>
void insert_range ( R && rg ) ; |
(C++23 起)
(自 C++26 起为 constexpr) |
|
将范围
rg
中的每个元素副本插入到底层容器
c
中,操作方式类似于:
for (const auto& e : rg) c.insert(c.end(), e);
随后,根据
compare
对新插入的元素范围进行排序。
将排序后的新元素范围与已存在元素的排序范围合并为单一有序范围。
范围内的每个迭代器 rg 都会被精确解引用一次。
若满足以下任一条件,则行为未定义:
-
value_type无法通过 * ranges:: begin ( rg ) 置入构造到flat_multiset中 - rg 与 * this 存在重叠
| 关于迭代器失效的信息复制自 此处 |
目录 |
参数
| rg | - |
一个
容器兼容范围
,即其元素可转换为
T
的
input_range
|
复杂度
S+N·log(N) ,其中 S 表示 size ( ) , N 表示 ranges:: distance ( rg ) 。
注释
由于
insert_range
执行的是原地合并操作,该操作可能会分配内存。
示例
#include <iostream> #include <flat_set> void println(auto, const auto& container) { for (const auto& elem : container) std::cout << elem << ' '; std::cout << '\n'; } int main() { auto container = std::flat_multiset{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 3 4
参见
|
插入元素
(公开成员函数) |