std::queue<T,Container>::emplace - cppreference.com

De cppreference.com

`template< class... Args > void emplace( Args&&... args );`		(desde C++11) (hasta C++17)
`template< class... Args > decltype(auto) emplace( Args&&... args );`		(desde C++17)

Encola un nuevo elemento al final de la cola. El elemento se construye en el sitio, es decir, no se realizan operaciones de copia o movimiento. El constructor del elemento se llama exactamente con los mismos argumentos que se le suplementaron a la función.

Efectivamente llama a c.emplace_back(std::forward<Args>(args)...);

Parámetros

args

Los argumentos a reenviar al constructor del elemento.

Valor de retorno

(Ninguno)	(hasta C++17)
El valor o referencia, si es que la hay, devuelta por la llamada anterior a `Container::emplace_back`.	(desde C++17)

Complejidad

Idéntica a la complejidad de Container::emplace_back.

Ejemplo

#include <iostream>
#include <queue>

struct S
{
    int id;

    S(int i, double d, std::string s) : id{i}
    {
        std::cout << "S::S(" << i << ", " << d << ", \"" << s << "\");\n";
    }
};

int main()
{
    std::queue<S> adaptador;

    const S& s = adaptador.emplace(42, 3.14, "C++"); // para valor de retorno requerido por C++17

    std::cout << "id = " << s.id << '\n';
}

Salida:

S::S(42, 3.14, "C++")
id = 42

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 2783	C++17	`emplace` devolvía `reference`, rompiendo la compatibilidad con contenedores anteriores a C++17.	Devuelve `decltype(auto)`

Véase también

	Encola un elemento al final de la cola. (función miembro pública) [editar]
	Desencola el elemento al frente de la cola. (función miembro pública) [editar]