名稱空間
變體
操作

std::stack<T,Container>::emplace

來自 cppreference.com
< cpp‎ | 容器‎ |
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] 另請參閱

在棧頂插入元素
(公共成員函式) [編輯]
移除頂部元素
(公共成員函式) [編輯]