std::list::insert_range

 

C++

Apoyo de compiladores

Implementaciones independientes y albergadas

Lenguaje

Biblioteca estándar

Encabezados de la biblioteca estándar

Requisitos denominados

Macros de prueba de característica (C++20)

Biblioteca de apoyo del lenguaje

Biblioteca de conceptos (C++20)

Biblioteca de diagnósticos

Biblioteca de gestión de memoria

Biblioteca de metaprogramación (C++11)

Biblioteca de servicios generales

Biblioteca de contenedores

Biblioteca de iteradores

Biblioteca de rangos (C++20)

Biblioteca de algoritmos

Biblioteca de cadenas

Biblioteca de procesamiento de texto

Biblioteca numérica

Biblioteca de fecha y hora

Biblioteca de entrada/salida

Biblioteca del sistema de archivos (C++17)

Biblioteca de apoyo de concurrencia (C++11)

Biblioteca de apoyo de ejecución (C++26)

Especificaciones técnicas

Índice de símbolos

Bibliotecas externas

 

Biblioteca de contenedores

De secuencias

array (C++11)

vector

vector<bool>

inplace_vector (C++26)

deque

forward_list (C++11)

list

Asociativos

set

multiset

map

multimap

Asociativos no ordenados

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Adaptadores

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Vistas

span (C++20)

mdspan (C++23)

Tablas

Invalidación de iteradores

Tabla de funciones miembro

Tabla de funciones no miembro

 

std::list

Funciones miembro
list::list list::~list list::operator=	list::assign list::assign_range (C++23) list::get_allocator
Acceso a elementos
list::front	list::back
Iteradores
list::beginlist::cbegin (C++11) list::endlist::cend (C++11)	list::rbeginlist::crbegin (C++11) list::rendlist::crend (C++11)
Capacidad
list::size list::empty	list::max_size
Modificadores
list::clear list::insert list::insert_range (C++23) list::emplace (C++11) list::erase list::push_front list::emplace_front (C++11)   list::prepend_range (C++23)	list::pop_front list::push_back list::emplace_back (C++11) list::append_range (C++23) list::pop_back list::resize list::swap
Operaciones
list::merge list::splice list::removelist::remove_if	list::reverse list::unique list::sort
Funciones no miembro
operator==operator!=operator<operator>operator<=operator>=operator<=> (hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(hasta C++20)(C++20)	swap(std::list) erase(std::list)erase_if(std::list) (C++20)(C++20)
Guías de deducción(C++17)

 

<tbody> </tbody>

template< rango-compatible-con-contenedores<T> R > iterator insert_range( const_iterator pos, R&& rg );		(desde C++23)

Inserta, en orden no inverso, copias de los elementos en rg antes que pos.

Cada iterador en el rango rg se desreferencia exactamente una vez.

El comportamiento no está definido si rg se superpone con el contenedor.

Parámetros

pos	-	Iterador antes del cual se insertará el contenido (pos puede ser el iterador end()).
rg	-	Un rango compatible con contenedores, es decir, un input_range cuyos elementos son convertibles a T.
Requisitos de tipo
- T debe ser EmplaceConstructible en list de *ranges::begin(rg). De lo contrario, el comportamiento no está definido.

Valor de retorno

Un iterador que apunta a la copia del primer elemento insertado en list o en pos si rg está vacío.

Notas

Macro de Prueba de característica	Valor	Estándar	Comentario
__cpp_lib_containers_ranges	202202L	(C++23)	Construcción e inserción consciente de rangos.

Ejemplo

Ejecuta este código

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

int main()
{
    auto container = std::list{1, 2, 3, 4};
    auto pos = std::next(container.begin(), 2);
    assert(*