std::map::emplace_hint

<metanoindex/>

 

C++

Поддержка компилятором

Автономные и размещённые реализации

Язык

Стандартная библиотека

Заголовки стандартной библиотеки

Требования к именованию

Макросы тестирования функциональности (C++20)

Поддержка языка

Библиотека концептов (C++20)

Библиотека метапрограммирования (C++11)

Библиотека диагностики

Библиотека общих утилит

Библиотека строк

Библиотека контейнеров

Библиотека итераторов

Библиотека диапазонов (C++20)

Библиотека алгоритмов

Библиотека численных данных

Библиотека ввода/вывода

Библиотека локализаций

Регулярные выражения (C++11)

Атомарные операции (C++11)

Библиотека поддержки конкуренции (C++11)

Библиотека файловой системы (C++17)

Технические спецификации

Указатель символов

Внешние библиотеки

 

Библиотека контейнеров

Последовательные

array (C++11)

vector

vector<bool>

deque

forward_list (C++11)

list

Ассоциативные

set

multiset

map

multimap

Неупорядоченные ассоциативные

unordered_set (C++11)

unordered_multiset (C++11)

unordered_map (C++11)

unordered_multimap (C++11)

Адаптеры

stack

queue

priority_queue

flat_set (C++23)

flat_multiset (C++23)

flat_map (C++23)

flat_multimap (C++23)

Представления

span (C++20)

mdspan (C++23)

Недействительные итераторы

Таблица функций-элементов

Таблица функций, не являющихся элементами

 

std::map

Функции элементы

map::map

map::~map

map::operator=

map::get_allocator

Доступ к элементам

map::at

map::operator[]

Итераторы

map::beginmap::cbegin (C++11)

map::endmap::cend (C++11)

map::rbeginmap::crbegin (C++11)

map::rendmap::crend (C++11)

Ёмкость

map::empty

map::size

map::max_size

Модификаторы

map::clear

map::insert

map::insert_range (C++23)

map::insert_or_assign (C++17)

map::emplace (C++11)

map::emplace_hint (C++11)

map::try_emplace (C++17)

map::erase

map::swap

map::extract (C++17)

map::merge (C++17)

Просмотр

map::count

map::find

map::contains (C++20)

map::equal_range

map::lower_bound

map::upper_bound

Наблюдатели

map::key_comp

map::value_comp

Функции, не являющиеся элементами

std::swap

erase_if (C++20)

operator==operator!=operator<operator>operator<=operator>=operator<=> (до C++20)(до C++20)(до C++20)(до C++20)(до C++20)(C++20)

Принципы вывода (C++17)

 

<tbody> </tbody>

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

Вставляет новый элемент в контейнер, используя hint как предположение для позиции в которую нужно вставить элемент. Элемент будет построен на месте, т.е. без операций копирования или перемещения. The constructor of the element type (value_type, that is, std::pair<const Key, T>) is called with exactly the same arguments as supplied to the function, forwarded with std::forward<Args>(args)....

Оригинал:

Inserts a new element to the container, using hint as a suggestion where the element should go. The element is constructed in-place, i.e. no copy or move operations are performed. The constructor of the element type (value_type, that is, std::pair<const Key, T>) is called with exactly the same arguments as supplied to the function, forwarded with std::forward<Args>(args)....

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Итераторы и указатели остаются в рабочем состоянии.

Параметры

hint	—	итератор, используемый в качестве предположения о позиции, в которую нужно вставить новый элемент Оригинал: iterator, used as a suggestion as to where to insert the new element Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.
args	—	Аргументы для перенаправления в конструктор элемента Оригинал: arguments to forward to the constructor of the element Текст был переведён автоматически используя Переводчик Google. Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

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

Возвращает итератор на вставленный элемент.

Оригинал:

Returns an iterator to the newly inserted element.

Текст был переведён автоматически используя Переводчик Google.
Вы можете проверить и исправить перевод. Для инструкций щёлкните сюда.

Если вставить элемент не удалось из-за того, что он уже присутствует в контейнере, то возвращается итератор на уже существующий элемент с эквивалентным ключом.

Сложность

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

См. также

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