std::forward_list<T,Allocator>:: insert_range_after
From cppreference.net
<
cpp
|
container
|
forward list
|
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:
-
Tno es EmplaceConstructible enforward_listdesde * ranges:: begin ( rg ) . -
pos
no está en el rango
[before_begin(),end()). - rg y * this se superponen.
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
Ejecutar este código
#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
|
(C++23)
|
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) |