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

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

Вставляет новый элемент в контейнер, используя hint в качестве подсказки о том, куда должен быть помещен элемент.

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

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

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

Параметры

hint	-	итератор, используемый как рекомендация по месту вставки нового элемента
args	-	аргументы для передачи конструктору элемента

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

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

Исключения

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

Сложность

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

Пример

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

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

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