std::stack<T,Container>::emplace
來自 cppreference.com
template< class... Args > void emplace( Args&&... args ); |
(C++11 起) (C++17 前) |
|
template< class... Args > decltype(auto) emplace( Args&&... args ); |
(C++17 起) | |
在棧頂推入一個新元素。該元素是就地構造的,即不執行復制或移動操作。元素的建構函式將使用與提供給函式完全相同的引數進行呼叫。
實際呼叫 c.emplace_back(std::forward<Args>(args)...);。
目錄 |
[edit] 引數
args | - | 轉發給元素建構函式的引數 |
[edit] 返回值
(無) |
(C++17 前) |
上述對 Container::emplace_back 的呼叫返回的值或引用(如果有)。 |
(C++17 起) |
[edit] 複雜度
與 Container::emplace_back 的複雜度相同。
[edit] 示例
執行此程式碼
#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'; }
輸出
S::S(42, 3.14, "C++") id = 42
缺陷報告
下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。
缺陷報告 | 應用於 | 釋出時的行為 | 正確的行為 |
---|---|---|---|
LWG 2783 | C++17 | emplace 返回 reference ,破壞了與 C++17 之前容器的相容性 |
返回 decltype(auto) |
[edit] 另請參閱
在棧頂插入元素 (公共成員函式) | |
移除頂部元素 (公共成員函式) |