Namespaces
Variants

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

From cppreference.net

C++
Containers library
std::queue
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++"); // для возвращаемого значения требуется C++17
    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)

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

вставляет элемент в конец
(public member function)
удаляет первый элемент
(public member function)