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

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

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

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

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

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

Параметры

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

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

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

Исключения

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

Сложность

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

Пример

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

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

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