std::deque<T,Allocator>::emplace

 

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::deque

Tipos miembro
Funciones miembro
deque::deque deque::~deque deque::operator=	deque::assign deque::assign_range (C++23) deque::get_allocator
Acceso a elementos
deque::at deque::operator[]	deque::front deque::back
Iteradores
deque::begindeque::cbegin (C++11) deque::enddeque::cend (C++11)	deque::rbegindeque::crbegin (C++11) deque::renddeque::crend (C++11)
Capacidad
deque::empty deque::size	deque::max_size deque::shrink_to_fit (DR*)
Modificadores
deque::clear deque::insert deque::insert_range (C++23) deque::emplace deque::erase deque::push_front deque::emplace_front (C++11)   deque::prepend_range (C++23)	deque::pop_front deque::push_back deque::emplace_back (C++11) deque::append_range (C++23) deque::pop_back deque::resize deque::swap
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::deque) erase(std::deque)erase_if(std::deque) (C++20)(C++20)
Guías de deducción(C++17)

 

template<class... Args> iterator emplace( const_iterator pos, Args&&... args);		(desde C++11)

Inserta un nuevo elemento en el contenedor directamente antes de la posición pos.

El elemento se construye a través de std::allocator_traits::construct, que por lo general utiliza new de ubicación para construir el elemento en el sitio en una ubicación proporcionada por el contenedor. Sin embargo, si la ubicación requerida ha sido ocupada por un elemento existente, el elemento insertado se construye primero en otra ubicación y luego se asigna por movimiento a la ubicación requerida.

Los argumentos args... se reenvían al constructor como std::forward<Args>(args).... args... puede referirse a un valor en el contenedor directamente o indirectamente.

Se invalidan todos los iteradores, incluyendo el iterador después del final. También se invalidan las referencias, a menos que pos == begin() o pos == end(), en cuyo caso no se invalidan.

Parámetros

pos	-	Iterador antes del cual se construirá el nuevo elemento.
args	-	Argumentos a reenviar al constructor del elemento.
Requisitos de tipo
- T (el tipo de elemento del contenedor) debe satisfacer los requisitos de MoveAssignable, MoveInsertable y EmplaceConstructible.

Valor de retorno

Iterador que apunta al elemento emplazado.

Complejidad

Lineal en la menor de las distancias entre la posición pos y cualquiera de los extremos del contenedor.

Excepciones

Si se lanza una excepción por otro que no sea el constructor de copia, el constructor de movimiento, el operador de asignación o el operador de asignación de movimiento del tipo de valor, o si se lanza una excepción mientras se usa emplace para insertar un solo elemento en cualquier extremidad del contenedor, no hay efectos (garantía de excepción fuerte).

De lo contrario, los efectos no están especificados.

Ejemplo

Ejecuta este código

#include <iostream>#include <string>#include <deque>   struct Un {std::string s; Un(std::string str): s(std::move(str)){std::cout<<" construido\n";} Un(const Un& o): s(o.s){std::cout<<" construido por copia\n";} Un(Un&& o): s(std::move(o.s)){std::cout<<" construido por movimiento\n";} Un& operator=(const Un& other){ s = other.s;std::cout<<" asignado por copia\n";return*this;} Un& operator=(Un&& other){ s = std::move(other.s);std::cout<<" asignado por movimiento\n";return*this;}};   int main(){std::deque<Un> container;   std::cout<<"construir 2 veces Un:\n"; Un dos {"dos"}; Un tres {"tres"};   std::cout<<"emplazar:\n"; container.emplace(container.end(), "uno");   std::cout<<"emplazar con Un&:\n"; container.emplace(container.end(), dos);   std::cout<<"emplazar con Un&&:\n"; container.emplace(container.end(), std::move(tres));   std::cout<<"contenido:\n";for(constauto& obj : container)std::cout<<' '<< obj.s;std::cout<<'\n';}

Salida:

construir 2 veces Un: construido construido emplazar: construido emplazar con Un&: construido por copia emplazar con Un&&: construido por movimiento contenido: uno dos tres

Informes de defectos

Los siguientes informes de defectos de cambio de comportamiento se aplicaron de manera retroactiva a los estándares de C++ publicados anteriormente.

ID	Aplicado a	Comportamiento según lo publicado	Comportamiento correcto
LWG 2164	C++11	No estaba claro si los argumentos se podían referir al contenedor.	Se clarificó.

Véase también

insert	Inserta elementos (función miembro pública)
emplace_back (C++11)	Construye un elemento en el sitio al final. (función miembro pública)