std::forward_list<T,Allocator>::insert_range_after

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

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

pos должен быть разыменовываемым итератором в диапазоне [begin(), end()) или итератором before_begin() (следовательно, end() не является допустимым аргументом для pos).

Ни один итератор или ссылка не становятся недействительными.

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

Параметры

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

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

Сложность

Линейная относительно размера rg.

Примечания

Пример

#include <algorithm>
#include <cassert>
#include <forward_list>
#include <iterator>
#include <vector>

int main()
{
    auto container = std::forward_list{1, 2, 3, 4};
    auto pos = std::next(container.cbegin());
    assert(*pos == 2);
    const auto rg = std::vector{-1, -2, -3};

#ifdef __cpp_lib_containers_ranges
    container.insert_range_after(pos, rg);
#else
    container.insert_after(pos, rg.cbegin(), rg.cend());
#endif
    
    assert(std::ranges::equal(container, std::vector{1, 2, -1, -2, -3, 3, 4}));
}

См. также