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

以非逆序方式，在 pos 前插入 rg 中元素的副本。

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

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

如果 rg 与 * this 存在重叠，则行为未定义。

参数

返回值

指向插入到 * this 的第一个元素的迭代器，若 rg 为空则返回 pos 。

注释

示例

#include <algorithm>
#include <cassert>
#include <iterator>
#include <vector>
#include <list>
int main()
{
    auto container = std::vector{1, 2, 3, 4};
    auto pos = std::next(container.begin(), 2);
    assert(*pos == 3);
    const auto rg = std::list{-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::vector{1, 2, -1, -2, -3, 3, 4}));
}

参见