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

 

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> void emplace_back( Args&&... args);		(desde C++11) (hasta C++17)
template<class... Args> reference emplace_back( Args&&... args);		(desde C++17)

Anexa un nuevo elemento al final del contenedor. 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. Los argumentos args... se reenvían al constructor como std::forward<Args>(args)....

Se invalidan todos los iteradores, incluyendo el iterador después del final. No se invalida ninguna referencia.

Parámetros

args	-	Argumentos a reenviar al constructor del elemento.
Requisitos de tipo
- T (el tipo de elemento del contenedor) debe satisfacer los requisitos de EmplaceConstructible.

Return value

(Ninguno)	(hasta C++17)
Una referencia al elemento insertado.	(desde C++17)

Complejidad

Constante.

Excepciones

Si se lanza una excepción, esta función no tiene efecto (garantía de excepción fuerte).

Ejemplo

El siguiente código utiliza emplace_back para anexar un objeto de tipo Presidente a un std::deque. Demuestra cómo emplace_back reenvía los parámetros al constructor de Presidente y muestra cómo el uso de emplace_back evita la operación de copia o movimiento extra requerida al usar push_back.

Ejecuta este código

#include <deque>#include <string>#include <cassert>#include <iostream>   struct Presidente {std::string nombre;std::string pais;int periodo;   Presidente(std::string p_nombre, std::string p_pais, int p_periodo): nombre(std::move(p_nombre)), pais(std::move(p_pais)), periodo(p_periodo){std::cout<<"Me construyen.\n";} Presidente(Presidente&& otro): nombre(std::move(otro.nombre)), pais(std::move(otro.pais)), periodo(otro.periodo){std::cout<<"Me mueven.\n";} Presidente& operator=(const Presidente& otro)=default;};   int main(){std::deque<Presidente> elecciones;std::cout<<"emplace_back:\n";auto& ref = elecciones.emplace_back("Nelson Mandela", "Sudáfrica", 1994);assert(ref.periodo==1994&&"usa una referencia al objeto creado (C++17)");   std::deque<Presidente> reelecciones;std::cout<<"\npush_back:\n"; reelecciones.push_back(Presidente("Franklin Delano Roosevelt", "los Estados Unidos", 1936));   std::cout<<"\nContenido:\n";for(Presidente const& presidente: elecciones){std::cout<< presidente.nombre<<" fue reelegido presidente de "<< presidente.pais<<" en "<< presidente.periodo<<".\n";}for(Presidente const& presidente: reelecciones){std::cout<< presidente.nombre<<" fue reelegido presidente de "<< presidente.pais<<" en "<< presidente.periodo<<".\n";}}

Salida:

emplace_back: Me construyen.   push_back: Me construyen. Me mueven.   Contenido: Nelson Mandela fue reelegido presidente de Sudáfrica en 1994. Franklin Delano Roosevelt fue reelegido presidente de los Estados Unidos en 1936.

Véase también

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