std::multimap<Key,T,Compare,Allocator>:: emplace_hint
|
(C++17)
|
||||
| Sequence | ||||
|
(C++11)
|
||||
|
(C++26)
|
||||
|
(C++26)
|
||||
|
(C++11)
|
||||
| Associative | ||||
| Unordered associative | ||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
|
(C++11)
|
||||
| Adaptors | ||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
|
(C++23)
|
||||
| Views | ||||
|
(C++20)
|
||||
|
(C++23)
|
||||
| Tables | ||||
| Iterator invalidation | ||||
| Member function table | ||||
| Non-member function table |
| Member functions | |||||||||||||||||||||||||||
| Non-member functions | |||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||
| Deduction guides (C++17) | |||||||||||||||||||||||||||
|
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
)
...
.
Никакие итераторы или ссылки не инвалидируются.
Содержание |
Параметры
| hint | - | итератор на позицию перед которой будет вставлен новый элемент |
| args | - | аргументы для передачи конструктору элемента |
Возвращаемое значение
Итератор на вставленный элемент.
Исключения
Если по какой-либо причине возникает исключение, эта функция не оказывает никакого эффекта ( гарантия строгой безопасности исключений ).
Сложность
Логарифмическая по размеру контейнера в общем случае, но амортизированная константная, если новый элемент вставляется непосредственно перед hint .
Пример
|
Этот раздел не завершён
Причина: отсутствует пример |
Смотрите также
|
(C++11)
|
создаёт элемент на месте
(публичная функция-член) |
|
вставляет элементы
или узлы
(начиная с C++17)
(публичная функция-член) |