std::stack<T,Container>::emplace
Von cppreference.com
template< class... Args > void emplace( Args&&... args ); |
(seit C++11) (bis C++17) |
|
| template< class... Args > decltype(auto) emplace( Args&&... args ); |
(seit C++17) | |
Fügt ein neues Element auf dem Stapel ein. Das Element wird direkt vor Ort konstruiert, d.h. es werden keine Kopier- oder Verschiebungsoperationen durchgeführt. Der Konstruktor des Elements wird mit exakt denselben Argumenten aufgerufen, die an die Funktion übergeben wurden.
Ruft effektiv c.emplace_back(std::forward<Args>(args)...); auf.
Inhalt |
[bearbeiten] Parameter
| args | - | Argumente, die an den Konstruktor des Elements weitergeleitet werden |
[bearbeiten] Rückgabewert
|
(keine) |
(bis C++17) |
|
Der Wert oder die Referenz, falls vorhanden, die vom obigen Aufruf von Container::emplace_back zurückgegeben wird. |
(seit C++17) |
[bearbeiten] Komplexität
Identisch mit der Komplexität von Container::emplace_back.
[bearbeiten] Beispiel
Führen Sie diesen Code aus
#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> stack; const S& s = stack.emplace(42, 3.14, "C++"); // for return value C++17 required std::cout << "id = " << s.id << '\n'; }
Ausgabe
S::S(42, 3.14, "C++") id = 42
Defect reports
Die folgenden Verhaltensändernden Fehlerberichte wurden rückwirkend auf zuvor veröffentlichte C++-Standards angewendet.
| DR | angewendet auf | Verhalten wie veröffentlicht | Korrigiertes Verhalten |
|---|---|---|---|
| LWG 2783 | C++17 | emplace gab reference zurück, was die Kompatibilität mit Containern vor C++17 brach |
gibt decltype(auto) zurück |
[bearbeiten] Siehe auch
| fügt ein Element oben ein (public member function) | |
| entfernt das oberste Element (public member function) |
