std::multimap<Key,T,Compare,Allocator>::emplace_hint
template< class... Args > iterator emplace_hint( const_iterator hint, Args&&... args ); | (начиная с C++11) |
Вставляет новый элемент в контейнер как можно ближе к позиции непосредственно перед hint.
Конструктор типа элемента (value_type, то есть std::pair<const Key, T>) вызывается с теми же аргументами, которые переданы функции, с использованием std::forward<Args>(args)....
Итераторы и ссылки не становятся недействительными.
Параметры
| hint | - | итератор на позицию, перед которой будет вставлен новый элемент |
| args | - | аргументы, передаваемые конструктору элемента |
Возвращаемое значение
Итератор на вставленный элемент.
Исключения
Если по какой-либо причине выбрасывается исключение, функция не оказывает никакого эффекта (гарантия строгой безопасности при исключениях).
Сложность
В общем случае логарифмическая относительно размера контейнера, но амортизированно постоянная, если новый элемент вставляется непосредственно перед hint.
Пример
См. также
|
(C++11) | создаёт элемент на месте (открытая функция-член) |
| вставляет элементы или узлы(начиная с C++17) (открытая функция-член) |
© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/multimap/emplace_hint