std::unordered_multiset<Key,Hash,KeyEqual,Allocator>:: emplace

template < class ... Args > iterator emplace ( Args && ... args ) ;		(начиная с C++11) (constexpr начиная с C++26)

Вставляет новый элемент в контейнер, созданный на месте с заданными args .

Конструктор нового элемента вызывается с точно такими же аргументами, которые были переданы в emplace , проброшенными через std:: forward < Args > ( args ) ... .

Если value_type не является EmplaceConstructible в unordered_multiset из args , поведение не определено.

Если после операции новое количество элементов превышает старое значение max_load_factor() * bucket_count() происходит рехэширование.
Если происходит рехэширование (из-за вставки), все итераторы становятся недействительными. В противном случае (без рехэширования) итераторы остаются действительными.

Содержание 1 Параметры 2 Возвращаемое значение 3 Исключения 4 Сложность 5 Примечания 6 Пример 7 Смотри также

Параметры

args

-

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

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

Итератор на вставленный элемент.

Исключения

Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).

Сложность

Амортизированная константа в среднем, в худшем случае линейная от размера контейнера.

Примечания

Аккуратное использование emplace позволяет создавать новый элемент, избегая ненужных операций копирования или перемещения.

Пример

Этот раздел не завершён Причина: отсутствует пример

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

emplace_hint	создаёт элементы на месте с использованием подсказки (публичная функция-член)
insert	вставляет элементы или узлы (начиная с C++17) (публичная функция-член)