Namespaces
Variants

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

From cppreference.net

C++
Containers library
std::stack
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 ) ... ) ; .

Содержание

Параметры

args - аргументы для передачи конструктору элемента

Возвращаемое значение

(нет)

(до C++17)

Значение или ссылка, если таковые имеются, возвращаемые вышеуказанным вызовом Container :: emplace_back .

(начиная с C++17)

Сложность

Идентично сложности Container :: emplace_back .

Пример

Запустить этот код 
#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++"); // для возвращаемого значения требуется C++17
    std::cout << "id = " << s.id << '\n';
}

Вывод: 

S::S(42, 3.14, "C++")
id = 42

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Applied to Behavior as published Correct behavior
LWG 2783 C++17 emplace returned reference , breaking compatibility with pre-C++17 containers returns decltype(auto)

Смотрите также

вставляет элемент на вершину
(public member function)
удаляет верхний элемент
(public member function)