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

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

如果操作后新的 size() 大于原来的 capacity() ，则会发生重新分配，这种情况下所有迭代器（包括 end() 迭代器）和所有元素引用都会失效。否则仅 end() 迭代器会失效。

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

参数

复杂度

如果发生重新分配，时间复杂度与结果 vector 的元素数量成线性关系；否则，时间复杂度与插入的元素数量加上到 end() 的距离成线性关系。

异常

若抛出的异常并非由 T 的拷贝构造函数、移动构造函数、赋值运算符或移动赋值运算符引发，也非由任何 InputIterator 操作引发，则不会产生任何影响。若在末尾插入单个元素时抛出异常，且 T 满足 可拷贝插入 要求，或 std::is_nothrow_move_constructible_v <T> 为 true ，则不会产生任何影响。否则，若异常由非 可拷贝插入 的 T 的移动构造函数抛出，则产生的影响是未指定的。

注释

示例

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

参见