std::vector<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::vector

Tipos miembro
Funciones miembro
vector::vector vector::~vector vector::operator=	vector::assign vector::assign_range (C++23) vector::get_allocator
Acceso a elementos
vector::at vector::operator[] vector::front	vector::back vector::data
Iteradores
vector::beginvector::cbegin (C++11) vector::endvector::cend (C++11)	vector::rbeginvector::crbegin (C++11) vector::rendvector::crend (C++11)
Capacidad
vector::empty vector::size vector::max_size	vector::reserve vector::capacity vector::shrink_to_fit (DR*)
Modificadores
vector::clear vector::insert vector::emplace (C++11) vector::insert_range (C++23)   vector::erase vector::push_back	vector::emplace_back (C++11) vector::append_range (C++23) vector::pop_back vector::resize vector::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::vector) erase(std::vector)erase_if(std::vector) (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) (hasta C++20)
template<class... Args> constexpr reference emplace_back( Args&&... args);		(desde C++20)

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)....

Si el nuevo tamaño (size()) es mayor que la capacidad (capacity()), incluyendo el iterador después del final, entonces se invalidan todos los iteradores y las referencias. De lo contrario, solamente se invalida el iterador después del final.

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 MoveInsertable y EmplaceConstructible.

Return value

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

Complejidad

Constante amortizada.

Excepciones

Si se lanza una excepción, esta función no tiene efecto (garantía de excepción fuerte). Si el constructor de movimiento de T no es noexcept y no es CopyInsertable en *this, el vector utilizará el constructor de movimiento que lanza una excepción. Si lanza, la garantía se anula y los efectos no están especificados.

Notas

Ya que puede ocurrir una reasignación de memoria, emplace_back requiere que el tipo de elemento sea MoveInsertable para vectores.

La especialización std::vector<bool> no tenía la función miembro emplace_back() hasta C++14.

Ejemplo

El siguiente código utiliza emplace_back para anexar un objeto de tipo Presidente a un std::vector. 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 <vector>#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::vector<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::vector<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)