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

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

Если выполняется любое из следующих условий, поведение не определено:

• T не является EmplaceConstructible в forward_list из * ranges:: begin ( rg ) .
• pos не находится в диапазоне [ before_begin() , end() ) .
• rg и * this пересекаются.

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

Параметры

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

Итератор на последний вставленный элемент, или 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}));
}

Смотрите также