Spec-Zone.ru › C++

std::multiset<Key,Compare,Allocator>::emplace_hint

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

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

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

Итераторы и ссылки не инвалидируются.

Параметры

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

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

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

Исключения

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

Сложность

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

Пример

См. также

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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/container/multiset/emplace_hint

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API