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 не должен пересекаться с контейнером. В противном случае поведение не определено.

Параметры

Возвращаемое значение

iterator, указывающий на копию первого элемента, вставленного в inplace_vector, или на pos, если rg пуст.

Исключения

• std::bad_alloc, если ranges::distance(rg) + size() > capacity(). Элементы *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); // throws: no space
    }
    catch(const std::bad_alloc& ex)
    {
        std::println("{}", ex.what());
    }
}

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

См. также