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

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 <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';
}

Вывод:

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

Отчёты об ошибках

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

DR	Применяется к	Опубликованное поведение	Правильное поведение
LWG 2783	C++17	`emplace` возвращал `reference`, нарушая совместимость с контейнерами до C++17	возвращает `decltype(auto)`

См. также

push	вставляет элемент в конец (открытая функция-член)
pop	удаляет первый элемент (открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/queue/emplace