Namespaces
Variants

std::flat_multiset<Key,Compare,KeyContainer>:: insert_range

From cppreference.net

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);
(代码部分保持原样,仅翻译说明性文字:) 该循环遍历范围rg中的每个元素,并将每个元素e插入到容器c的末尾位置。

随后,根据 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

参见

插入元素
(公开成员函数)