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

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ(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)

 

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_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

推定ガイド(C++17)

 

template<class M> pair<iterator, bool> insert_or_assign(const key_type& k, M&& obj);	(1)	(C++17以上)
template<class M> 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 と等しいキーがすでに存在する場合は、キー k に対応する mapped_type に std::forward<M>(obj) が代入されます。キーが存在しない場合は、 insert によって行われたかのように、新しい値が value_type(k, std::forward<M>(obj)) から構築されて挿入されます。

2,4)(1,3) と同様ですが、値は value_type(std::move(k), std::forward<M>(obj)) から構築されます。

どのイテレータも参照も無効化されません。

引数

k	-	検索および見つからなかった場合の挿入の両方に使われるキー
hint	-	前に新しい要素が挿入される位置を指すイテレータ
obj	-	挿入または代入する値

戻り値

1,2) bool 部分は、挿入が行われた場合は true、代入が行われた場合は false になります。 イテレータ部分は、挿入または更新された要素を指します。

3,4) 挿入または更新された要素を指すイテレータ。

計算量

1,2)emplace と同じ。

3,4)emplace_hint と同じ。

ノート

insert_or_assign は operator[] より多くの情報を返し、マップされる型のデフォルト構築可能性を要求しません。

例

Run this code

#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(constauto&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)	要素をその場で構築します (パブリックメンバ関数)