std::stack<T,Container>::emplace
De cppreference.com
<tbody>
</tbody>
template< class... Args > void emplace( Args&&... args ); |
(desde C++11) (hasta C++17) |
|
template< class... Args > decltype(auto) emplace( Args&&... args ); |
(desde C++17) | |
Apila un nuevo elemento en la parte superior de la pila. 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
Ejecuta este código
#include <iostream>
#include <stack>
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::stack<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
| Apila un elemento en la parte superior de la pila. (función miembro pública) | |
| Desapila el elemento en la parte superior de la pila. (función miembro pública) |