命名空间
变体
操作

std::list<T,Allocator>::insert_range

来自 cppreference.cn
< cpp‎ | 容器‎ | list
 
 
 
 
template< container-compatible-range<T> R >
iterator insert_range( const_iterator pos, R&& rg );
(C++23 起)

pos 之前,以非反转顺序插入 rg 中元素的副本。

迭代器或引用均未失效。

范围 rg 中的每个迭代器被解引用一次。

rg 不得与容器重叠。否则,行为是未定义的。

目录

[编辑] 参数

pos - 内容将插入在其之前的迭代器(pos 可以是 end() 迭代器)
rg - 一个 容器兼容范围,即一个 input_range,其元素可转换为 T
类型要求
-
T 必须能够从 *ranges::begin(rg) EmplaceConstructiblelist 中。否则,行为是未定义的。

[编辑] 返回值

一个 iterator,它指向插入到 list 中的第一个元素的副本,如果 rg 为空,则指向 pos

注意

特性测试 标准 特性
__cpp_lib_containers_ranges 202202L (C++23) 范围感知(Ranges-aware)构造和插入

[编辑] 示例

#include <algorithm>
#include <cassert>
#include <iterator>
#include <list>
#include <vector>
 
int main()
{
    auto container = std::list{1, 2, 3, 4};
    auto pos = std::next(container.begin(), 2);
    assert(*pos == 3);
    const auto rg = std::vector{-1, -2, -3};
 
#ifdef __cpp_lib_containers_ranges
    container.insert_range(pos, rg);
#else
    container.insert(pos, rg.cbegin(), rg.cend());
#endif
    assert(std::ranges::equal(container, std::list{1, 2, -1, -2, -3, 3, 4}));
}

[编辑] 另请参阅

插入元素
(公开成员函数)
添加一个元素范围到起始
(公开成员函数)
添加一个元素范围到结尾
(公开成员函数)