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

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

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

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

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

Параметры

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

Возвращает итератор на вставленный элемент.

Исключения

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

Сложность

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

Пример

См. также