std::unordered_multimap<Key,T,Hash,KeyEqual,Allocator>:: emplace_hint
|
template
<
class
...
Args
>
iterator emplace_hint ( const_iterator hint, Args && ... args ) ; |
(начиная с C++11)
(constexpr начиная с C++26) |
|
Вставляет новый элемент в контейнер, используя hint в качестве рекомендации, куда должен быть помещён элемент.
Конструктор
value_type
(т.е.,
std::
pair
<
const
Key, T
>
) вызывается с точно такими же аргументами, которые были переданы в функцию, проброшенными с помощью
std::
forward
<
Args
>
(
args
)
...
.
Если после операции новое количество элементов становится больше, чем старое
max_load_factor()
*
bucket_count()
происходит рехэширование.
Если происходит рехэширование (из-за вставки), все итераторы становятся недействительными. В противном случае (если рехэширования не происходит) итераторы остаются действительными.
Содержание |
Параметры
| hint | - | итератор, используемый как подсказка о том, куда вставить новый элемент |
| args | - | аргументы для передачи конструктору элемента |
Возвращаемое значение
Итератор на вставленный элемент.
Исключения
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( strong exception safety guarantee ).
Сложность
Амортизированная константа в среднем, в худшем случае линейная от размера контейнера.
Пример
|
Этот раздел не завершён
Причина: отсутствует пример |
Смотрите также
|
создаёт элемент на месте
(публичная функция-член) |
|
|
вставляет элементы
или узлы
(начиная с C++17)
(публичная функция-член) |