Espacios de nombres
Variantes
Acciones

std::queue<T,Container>::emplace

De cppreference.com
< cpp‎ | container‎ | queue
 
 
 
 
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)...);

Contenido

[editar] Parámetros

args - Los argumentos a reenviar al constructor del elemento.

[editar] 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)

[editar] Complejidad

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

[editar] 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)

[editar] 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]