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 M > iterator insert_or_assign( const_iterator hint, const Key& k, M&& obj );	(3)	(с C++17)
template< class M > iterator insert_or_assign( const_iterator hint, Key&& k, M&& obj );	(4)	(с C++17)

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

2,4) Аналогично (1,3), за исключением того, что значение сопоставлено создаётся из value_type(std::move(k), std::forward<M>(obj)).

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

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

Параметры

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

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

1,2) Логическое значение (bool) равно true, если вставка прошла успешно, и false, если присвоение прошло успешно. Итератор указывает на элемент, который был вставлен или обновлён.

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

Сложность

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

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

Примечания

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

Макрокоманда проверки наличия функции	Значение	Std	Функция
`__cpp_lib_map_try_emplace`	201411L	(C++17)	`std::map::try_emplace`, `std::map::insert_or_assign`

Пример

#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/w/cpp/container/map/insert_or_assign