std::list::insert

See More

 

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> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

	(1)
iterator insert( iterator pos, const T& value );			(hasta C++11)
iterator insert( const_iterator pos, const T& value );			(desde C++11)
iterator insert( const_iterator pos, T&& value );		(2)	(desde C++11)
		(3)
void insert( iterator pos, size_type count, const T& value );				(hasta C++11)
iterator insert( const_iterator pos, size_type count, const T& value );				(desde C++11)
			(4)
template< class InputIt > void insert( iterator pos, InputIt first, InputIt last );					(hasta C++11)
template< class InputIt > iterator insert( const_iterator pos, InputIt first, InputIt last );					(desde C++11)
iterator insert( const_iterator pos, std::initializer_list<T> ilist );				(5)	(desde C++11)

Inserta elementos en el contenedor en la ubicación especificada.

1-2) Inserta el valor value antes de la posición pos.

3) Inserta count copias del valor value antes de la posición pos.

4) Inserta elementos del rango [first, last) antes de la posición pos.

Esta sobrecarga tiene el mismo efecto que la sobrecarga (3) si InputIt es un tipo entero.	(hasta C++11)
Esta sobrecarga solo participa en la resolución de sobrecargas si InputIt califica como InputIterator, para evitar ambigüedad con la sobrecarga (3).	(desde C++11)

El comportamiento no está definido si first y last son iteradores en *this.

5) Inserta elements de la lista de inicializadores ilist antes de la posición pos.

No se invalidan ni referencias ni iteradores.

Parámetros

pos	-	Iterador antes del cual se insertará el contenido. La posición pos puede ser el iterador end().
value	-	Valor del elemento a insertar.
first, last	-	El rango de los elementos a insertar, no pueden ser iteradores en el contenedor para el que se llama la función de inserción.
ilist	-	Lita de inicializadores de la cual insertar los valores.
Requisitos de tipo
- T debe satisfacer los requisitos de CopyInsertable para poder usar la sobrecarga (1).
- T debe satisfacer los requisitos de MoveInsertable para poder usar la sobrecarga (2).
- T debe satisfacer los requisitos de CopyAssignable y CopyInsertable para poder usar la sobrecarga (3).
- T debe satisfacer los requisitos de EmplaceConstructible para poder usar la sobrecarga (4,5).

Valor de retorno

1-2) Iterador que apunta al valor value insertado

3) Iterador que apunta al primer elemento insertado, o a la posición pos si count==0.

4) Iterador que apunta al primer elemento insertado, o a la posición pos si first==last.

5) Iterador que apunta al primer elemento insertado, o a la posición pos si ilist está vacía.

Complejidad

1-2) Constante.

3) Lineal en count

4) Lineal en std::distance(first, last)

5) Lineal en ilist.size()

Excepciones

Si se lanza una excepción, no hay efectos (garantía de excepción fuerte).

Véase también

emplace (C++11)	Construye el elemento en el sitio. (función miembro pública)
push_front	Inserta un elemento al principio del contenedor. (función miembro pública)
push_back	Agrega elementos al final. (función miembro pública)