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

template< class... Args >
iterator emplace( Args&&... args );

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

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

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

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

Параметры

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

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

Исключения

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

Сложность

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

Пример

См. также