std::queue<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 am Ende der Queue ein. Das Element wird vor Ort konstruiert, d.h. es werden keine Kopier- oder Verschiebeoperationen durchgeführt. Der Konstruktor des Elements wird mit genau denselben Argumenten aufgerufen, die an die Funktion übergeben werden.
Ruft effektiv auf 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 von dem obigen Aufruf von Container::emplace_back zurückgegebene Wert oder die Referenz, falls vorhanden. |
(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 <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> queue; const S& s = queue.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 unterbrach |
gibt decltype(auto) zurück |
[bearbeiten] Siehe auch
| fügt ein Element am Ende ein (public member function) | |
| entfernt das erste Element (public member function) |
