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

在 end() 之前插入范围 rg 中元素的副本，保持原有顺序。

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

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

参数

复杂度

与 rg 的大小呈线性关系。对 T 构造函数的调用次数恰好等于 std :: ranges:: size ( rg ) ) 。

异常

若因任何原因抛出异常，此函数不产生任何效果（ 强异常安全保证 ）。

注释

示例

#include <cassert>
#include <list>
#include <vector>
int main()
{
    auto head = std::list{1, 2, 3, 4};
    const auto tail = std::vector{-5, -6, -7};
#ifdef __cpp_lib_containers_ranges
    head.append_range(tail);
#else
    head.insert(head.end(), tail.cbegin(), tail.cend());
#endif
    assert((head == std::list{1, 2, 3, 4, -5, -6, -7}));
}

参见