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

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

(с C++23)

Вставляет в порядке следования копии элементов из rg перед pos.

Если после операции новое size() больше старого capacity(), происходит перераспределение памяти, в этом случае все итераторы (включая end() итератор) и все ссылки на элементы становятся недействительными. В противном случае, действительными остаются только итераторы и ссылки перед точкой вставки.

Каждый итератор в диапазоне rg используется для получения значения ровно один раз.

Поведение не определено, если rg перекрывается с контейнером.

Параметры

pos	-	итератор перед которым будет вставлено содержимое (`pos` может быть `end()` итератором)
rg	-	соответствующий контейнеру диапазон, т.е. `input_range`, элементы которого могут быть преобразованы в `T`
Требования к типу
-`T` должен быть EmplaceConstructible в `vector` из `*ranges::begin(rg)`. Также, `T` должен быть MoveInsertable в `vector` и `T` удовлетворяет условиям MoveConstructible, MoveAssignable и Swappable. В противном случае поведение не определено.

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

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

Примечания

Макрокоманда проверки наличия функции	Значение	Std	Функция
`__cpp_lib_containers_ranges`	202202L	(C++23)	Поддержка диапазонов при построении и вставке

Пример

#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}));
}

См. также

insert	вставка элементов (публичный член-функция)
append_range (C++23)	добавление диапазона элементов в конец (публичный член-функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/vector/insert_range