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

template <class M> std::pair<iterator, bool> insert_or_assign(const key_type& k, M&& obj);	(1)	(C++17 起)
template <class M> std::pair<iterator, bool> insert_or_assign(key_type&& k, M&& obj);	(2)	(C++17 起)
template <class M> iterator insert_or_assign(const_iterator hint, const key_type& k, M&& obj);	(3)	(C++17 起)
template <class M> iterator insert_or_assign(const_iterator hint, key_type&& k, M&& obj);	(4)	(C++17 起)

1,3) 若等价于 k 的键已存在于容器中，则赋值 std::forward<M>(obj) 给对应于键 k 的 mapped_type 。若键不存在，则如同用 insert 插入从 value_type(k, std::forward<M>(obj)) 构造的新值。

2,4) 同 (1,3) ，除了从 value_type(std::move(k), std::forward<M>(obj)) 构造被映射值。

若 std::is_assignable_v<mapped_type&, M&&> 为 false 则行为未定义 (C++20 前)程序非良构 (C++20 起)。

没有迭代器或引用被非法化。

参数

k	-	用于查找和若找不到则插入的键
hint	-	指向新元素将要插入位置之前位置的迭代器
obj	-	要插入或赋值的值

返回值

1,2) 若插入发生则 bool 组分为 true ，若赋值发生则 bool 组分为 false 。迭代器组分指向插入或更新的元素。

3,4) 指向被插入或更新的元素的迭代器。

复杂度

1,2) 与 emplace 的相同

3,4) 与 emplace_hint 的相同

注解

insert_or_assign 返回多于 operator[] 的信息，而且不要求被映射类型的可默认构造性。

示例

运行此代码

#include <iostream>
#include <map>
#include <string>
 
int main()
{
    std::map<std::string, std::string> myMap;
    myMap.insert_or_assign("a", "apple"     );
    myMap.insert_or_assign("b", "bannana"   );
    myMap.insert_or_assign("c", "cherry"    );
    myMap.insert_or_assign("c", "clementine");
 
    for (const auto &pair : myMap) {
        std::cout << pair.first << " : " << pair.second << '\n';
    }
}

输出：

a : apple
b : bannana
c : clementine

参阅

operator[]	访问或插入指定的元素 (公开成员函数)
at (C++11)	访问指定的元素，同时进行越界检查 (公开成员函数)
insert	插入元素或结点 (C++17 起) (公开成员函数)
emplace (C++11)	原位构造元素 (公开成员函数)

语言
标准库头文件
自立与有宿主实现
具名要求
语言支持库
概念库 (C++20)
诊断库
工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
原子操作库 (C++11)
线程支持库 (C++11)
技术规范

array (C++11)
vector
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
span (C++20)

成员函数
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_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)