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

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

(начиная с C++23)

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

Все итераторы (включая итератор end()) становятся недействительными. Ссылки также становятся недействительными, кроме случаев, когда pos== begin() или pos== end(): в этом случае они остаются действительными.

Каждый итератор в диапазоне rg разыменовывается ровно один раз.

rg не должен пересекаться с контейнером. В противном случае поведение не определено.

Параметры

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

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

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

Примечания

Макрос проверки поддержки возможностей	Значение	Стандарт	Возможность
`__cpp_lib_containers_ranges`	`202202L`	(C++23)	Конструирование и вставка с поддержкой диапазонов

Пример

#include <algorithm>
#include <cassert>
#include <iterator>
#include <deque>
#include <list>

int main()
{
    auto container = std::deque{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::deque{1, 2, -1, -2, -3, 3, 4}));
}

См. также

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

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