std::map<Key,T,Compare,Allocator>::insert_or_assign

template< class M > std::pair<iterator, bool> insert_or_assign( const Key& k, M&& obj );	(1)	(начиная с C++17)
template< class M > std::pair<iterator, bool> insert_or_assign( Key&& k, M&& obj );	(2)	(начиная с C++17)
template< class K, class M > std::pair<iterator, bool> insert_or_assign( K&& k, M&& obj );	(3)	(начиная с C++26)
template< class M > iterator insert_or_assign( const_iterator hint, const Key& k, M&& obj );	(4)	(начиная с C++17)
template< class M > iterator insert_or_assign( const_iterator hint, Key&& k, M&& obj );	(5)	(начиная с C++17)
template< class K, class M > iterator insert_or_assign( const_iterator hint, K&& k, M&& obj );	(6)	(начиная с C++26)

1,4) Если в контейнере уже существует ключ, эквивалентный k, присваивает std::forward<M>(obj) объекту типа mapped_type, соответствующему ключу k. Если ключ не существует, вставляет новое значение так же, как это делает insert, создавая его из value_type(k, std::forward<M>(obj)).

2,5) То же, что и (1,4), за исключением того, что отображаемое значение создаётся из value_type(std::move(k), std::forward<M>(obj)).

3,6) Если в контейнере уже существует ключ, эквивалентный k, присваивает std::forward<M>(obj) объекту типа mapped_type, соответствующему ключу k. Если ключ не существует, создаёт объект u типа value_type с помощью std::forward<K>(k), std::forward<M>(obj)), а затем вставляет u в *this. Если equal_range(u.first) == equal_range(k) имеет значение false, поведение не определено. Тип value_type должен удовлетворять требованию EmplaceConstructible для map из std::forward<K>(k), std::forward<M>(obj). Эта перегрузка участвует в разрешении перегрузки, только если квалифицированный идентификатор Compare::is_transparent корректен и обозначает тип. Это позволяет вызывать эту функцию, не создавая экземпляр Key.

Поведение не определено(до C++20)Программа некорректна(начиная с C++20), если std::is_assignable_v<mapped_type&, M&&> имеет значение false.

Итераторы и ссылки не становятся недействительными.

Параметры

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

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

1-3) Компонент bool равен true, если произошла вставка, и false, если произошло присваивание. Компонент-итератор указывает на вставленный или обновлённый элемент.

4-6) Итератор, указывающий на вставленный или обновлённый элемент.

Сложность

1-3) Такая же, как у emplace.

4-6) Такая же, как у emplace_hint.

Примечания

insert_or_assign возвращает больше информации, чем operator[], и не требует, чтобы отображаемый тип был конструируемым по умолчанию.

Макрос проверки наличия функции	Значение	Стандарт	Функция
`__cpp_lib_map_try_emplace`	`201411L`	(C++17)	`std::map::try_emplace`, `std::map::insert_or_assign`
`__cpp_lib_associative_heterogeneous_insertion`	`202311L`	(C++26)	Гетерогенные перегрузки для остальных функций-членов упорядоченных и неупорядоченных ассоциативных контейнеров. Перегрузки (3) и (6).

Пример

#include <iostream>
#include <string>
#include <map>

void print_node(const auto& node)
{
    std::cout << '[' << node.first << "] = " << node.second << '\n';
}

void print_result(auto const& pair)
{
    std::cout << (pair.second ? "inserted: " : "assigned: ");
    print_node(*pair.first);
}

int main()
{
    std::map<std::string, std::string> myMap;

    print_result(myMap.insert_or_assign("a", "apple"));
    print_result(myMap.insert_or_assign("b", "banana"));
    print_result(myMap.insert_or_assign("c", "cherry"));
    print_result(myMap.insert_or_assign("c", "clementine"));

    for (const auto& node : myMap)
        print_node(node);
}

Вывод:

inserted: [a] = apple
inserted: [b] = banana
inserted: [c] = cherry
assigned: [c] = clementine
[a] = apple
[b] = banana
[c] = clementine

См. также

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

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