std::inplace_vector<T,N>::insert_range

template< container-compatible-range<T> R >
constexpr iterator insert_range( const_iterator pos, R&& rg );

以不反转的顺序，将在 rg 之前的元素副本插入到 pos。

范围中的每个迭代器 rg 恰好被解引用一次。

rg 不得与容器重叠。否则行为未定义。

参数

返回值

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

异常处理

• 若 ranges:: distance ( rg ) + size ( ) > capacity ( ) 则抛出 std::bad_alloc 。此时 * this 的元素不会被修改。
• 插入操作（即 T 的复制/移动构造函数、移动/复制赋值运算符）或任何 LegacyInputIterator 操作所抛出的异常。此时 * this 在范围 [ ​ 0 ​ , pos ) 内的元素不会被修改。

示例

#include <cassert>
#include <inplace_vector>
#include <iterator>
#include <new>
#include <print>
int main()
{
    auto v = std::inplace_vector<int, 8>{0, 1, 2, 3};
    auto pos = std::next(v.begin(), 2);
    assert(*pos == 2);
    const auto rg = {-1, -2, -3};
    v.insert_range(pos, rg);
    std::println("{}", v);
    try
    {
        assert(v.size() + rg.size() > v.capacity());
        v.insert_range(pos, rg); // 抛出异常：空间不足
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
}

[0, 1, -1, -2, -3, 2, 3]
std::bad_alloc

参见