std::queue<T,Container>::emplace
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)...);
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
Ejecuta este código
#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) | |
Desencola el elemento al frente de la cola. (función miembro pública) |