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

在 end() 之前插入来自范围 rg 的元素的副本，保持非逆序排列。

所有迭代器（包括 end() 迭代器）都将失效。所有引用保持有效。

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

参数

复杂度

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

异常

若抛出的异常并非由 T 的复制构造函数、移动构造函数、赋值运算符或移动赋值运算符引发，则不会产生任何效果。若在任一端插入单个元素时抛出异常，则不会产生任何效果。否则，若异常由非 CopyInsertable 类型 T 的移动构造函数抛出，则效果未指定。

注释

示例

#include <cassert>
#include <deque>
#include <list>
int main()
{
    auto head = std::deque{1, 2, 3, 4};
    const auto tail = std::list{-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::deque{1, 2, 3, 4, -5, -6, -7}));
}

参见