std::flat_map<Key,T,Compare,KeyContainer,MappedContainer>:: 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.keys.insert(c.keys.end(), e.first); c.values.insert(c.values.end(), e.second); }
随后,根据 value_comp() 对新插入的元素范围进行排序。 将排序后的新元素范围与已存在元素的排序范围合并为单一有序范围。 最后,按如下方式擦除重复元素:
auto zv = views::zip(c.keys, c.values); auto it = ranges::unique(zv, key_equiv(compare)).begin(); auto dist = std::distance(zv.begin(), it); c.keys.erase(c.keys.begin() + dist, c.keys.end()); c.values.erase(c.values.begin() + dist, c.values.end());
范围内的每个迭代器 rg 都会被精确解引用一次。
若满足以下任一条件,则行为未定义:
-
value_type无法从 * ranges:: begin ( rg ) 就位构造到flat_map中 - rg 与 * this 存在重叠区域
| 关于迭代器失效的信息复制自 此处 |
目录 |
参数
| rg | - |
一个
容器兼容范围
,即其元素可转换为
T
类型的
input_range
|
复杂度
S+N·log(N) ,其中 S 表示 size ( ) , N 表示 ranges:: distance ( rg ) 。
注释
由于
insert_range
执行的是原地合并操作,该操作可能会分配内存。
示例
#include <iostream> #include <flat_map> #include <utility> void println(auto, const auto& container) { for (const auto& [key, value] : container) std::cout << '{' << key << ',' << value << '}' << ' '; std::cout << '\n'; } int main() { auto container = std::flat_map{std::pair{1, 11}, {3, 33}, {2, 22}, {4, 44}}; const auto rg = {std::pair{-1, -11}, {3, -33}, {-2, -22}}; #ifdef __cpp_lib_containers_ranges container.insert_range(rg); #else container.insert(rg.begin(), rg.end()); #endif println("{}", container); }
输出:
{-2,-22} {-1,-11} {1,11} {2,22} {3,33} {4,44}
另请参阅
|
插入元素
(公开成员函数) |