std::stack emplace() 方法

自 C++17 起

// Non const version only
template< class... Args >
decltype(auto) emplace( Args&&... args );

自 C++11 起

// Non const version only
template< class... Args >
void emplace( Args&&... args );

将一个新元素推入栈的末尾。该元素是在原地构造的，即不执行复制或移动操作。元素的构造函数将使用与提供给函数完全相同的参数进行调用。

注意

实际调用

c.emplace_back(std::forward<Args>(args)...)

参数

• args - 转发给元素构造函数的参数

返回值

自 C++17 起

(无)

C++17 之前

上述对底层容器的 emplace_back 调用返回的（如果有）值或引用。

异常

等同于底层容器的 emplace_back。

复杂度

等同于底层容器的 emplace_back。

示例

Main.cpp

#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> adaptor;
 
    const S& s = adaptor.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