Namespaces
Variants

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

From cppreference.net
template < container-compatible-range < T > R >
iterator insert_range_after ( const_iterator pos, R && rg ) ;
(desde C++23)
(constexpr desde C++26)

Inserta copias de los elementos en el rango rg después de pos . Cada iterador en el rango rg es desreferenciado exactamente una vez.

Si se satisface cualquiera de las siguientes condiciones, el comportamiento es indefinido:

Ningún iterador o referencia se invalida.

Contenidos

Parámetros

pos - un iterador después del cual se insertará el contenido
rg - un rango compatible con contenedor , es decir, un input_range cuyos elementos son convertibles a T

Valor de retorno

Un iterador al último elemento insertado, o pos si rg está vacío.

Complejidad

Lineal en tamaño de rg .

Notas

Macro de prueba de características Valor Std Característica
__cpp_lib_containers_ranges 202202L (C++23) Construcción e inserción con reconocimiento de rangos

Ejemplo

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

Véase también

agrega un rango de elementos al principio
(función miembro pública)
inserta elementos después de un elemento
(función miembro pública)
construye elementos in-situ después de un elemento
(función miembro pública)