std::map::insert

 

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)

 

std::pair<iterator,bool> insert(const value_type& value );	(1)
template<class P> std::pair<iterator,bool> insert( P&& value );	(2)	(начиная с C++11)
iterator insert( iterator hint, const value_type& value ); iterator insert( const_iterator hint, const value_type& value );	(3)	(до C++11) (начиная с C++11)
template<class P> iterator insert( const_iterator hint, P&& value );	(4)	(начиная с C++11)
template<class InputIt > void insert( InputIt first, InputIt last );	(5)
void insert(std::initializer_list<value_type> ilist );	(6)	(начиная с C++11)

Inserts element(s) to the container, if the container doesn't already contain an element with equivalent key.

1-2)

вставками value.

Оригинал:

inserts value.

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

3-4) inserts value in the position as close as possible, just prior(начиная с C++11), to hint.

5)

вставками элементов из диапазона [first, last).

Оригинал:

inserts elements from range [first, last).

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

6)

вставками элементов из списка инициализации ilist.

Оригинал:

inserts elements from initializer list ilist.

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

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

Параметры

hint	—	итератор, используемый как предположение о том, куда вставить элементы
value	—	вставляемое значение
first, last	—	диапазон элементов, которые нужно вставить
ilist	—	список инициализаторов, который нужно вставить
Требования к типам
- InputIt должен соответствовать требованиям InputIterator.

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

1-2) пару из итератора на вставленный элемент (или на тот, который помешал вставке), и bool, указывающий, была ли вставка.

3-4) итератор на вставленный элемент, или на тот, который помешал вставке.

5-6) ничего.

Сложность

1-2) Логарифмическая по размеру контейнера, O(log(size())).

3-4) Амортизированная константа, если вставка происходит в позицию прямо после хинта. Иначе — логарифмическая по размеру контейнера.	(до C++11)
3-4) Амортизированная константа, если вставка происходит в позицию прямо перед хинтом. Иначе — логарифмическая по размеру контейнера.	(начиная с C++11)

5-6)O(N*log(size() + N)), где N — сколько элементов вставить.

См. также

emplace (C++11)	создаёт элемент на месте (public функция-элемент)
emplace_hint (C++11)	создаёт элементы на месте, используя подсказку (public функция-элемент)