std::forward_list<T,Allocator>:: insert_range_after

在 pos 之后插入范围 rg 中元素的副本。范围 rg 中的每个迭代器都会被精确解引用一次。

若满足以下任一条件，则行为未定义：

• T 无法从 * ranges:: begin ( rg ) 进行 原位构造 到 forward_list 中。
• pos 不在 [ before_begin() , end() ) 范围内。
• rg 与 * this 存在重叠。

不会使任何迭代器或引用失效。

参数

返回值

指向最后插入元素的迭代器，若 rg 为空则返回 pos 。

复杂度

线性于 rg 的大小。

注释

示例

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

参见