Namespaces
Variants

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

From cppreference.net

C++
Containers library
std::map
Member functions
Non-member functions
(until C++20) (until C++20) (until C++20) (until C++20) (until C++20)
Deduction guides (C++17)
template < class M >
std:: pair < iterator, bool > insert_or_assign ( const Key & k, M && obj ) ;
(1) (seit C++17)
template < class M >
std:: pair < iterator, bool > insert_or_assign ( Key && k, M && obj ) ;
(2) (seit C++17)
template < class K, class M >
std:: pair < iterator, bool > insert_or_assign ( K && k, M && obj ) ;
(3) (seit C++26)
template < class M >
iterator insert_or_assign ( const_iterator hint, const Key & k, M && obj ) ;
(4) (seit C++17)
template < class M >
iterator insert_or_assign ( const_iterator hint, Key && k, M && obj ) ;
(5) (seit C++17)
template < class K, class M >
iterator insert_or_assign ( const_iterator hint, K && k, M && obj ) ;
(6) (seit C++26)
1,4) Falls ein Schlüsseläquivalent zu k bereits im Container existiert, weist std:: forward < M > ( obj ) dem mapped_type zu, das dem Schlüssel k entspricht. Falls der Schlüssel nicht existiert, fügt den neuen Wert ein, als ob durch insert , und konstruiert ihn aus value_type ( k, std:: forward < M > ( obj ) ) .
2,5) Gleich wie (1,4) , außer dass der zugeordnete Wert aus value_type ( std :: move ( k ) , std:: forward < M > ( obj ) ) konstruiert wird.
3,6) Falls ein Schlüsseläquivalent zu k bereits im Container existiert, weist std:: forward < M > ( obj ) dem mapped_type zu, das dem Schlüssel k entspricht. Falls der Schlüssel nicht existiert, wird ein Objekt u vom Typ value_type mit std:: forward < K > ( k ) , std:: forward < M > ( obj ) ) konstruiert und anschließend u in * this eingefügt. Wenn equal_range ( u. first ) == equal_range ( k ) false ist, ist das Verhalten undefiniert. Der value_type muss EmplaceConstructible in map aus std:: forward < K > ( k ) , std:: forward < M > ( obj ) sein. Diese Überladung nimmt nur an der Überladungsauflösung teil, wenn Compare transparent ist. Sie ermöglicht den Aufruf dieser Funktion, ohne eine Instanz von Key zu konstruieren.

Das Verhalten ist undefiniert (bis C++20) Das Programm ist fehlerhaft (seit C++20) falls std:: is_assignable_v < mapped_type & , M && > gleich false ist.

Keine Iteratoren oder Referenzen werden ungültig.

Inhaltsverzeichnis

Parameter

k - der Schlüssel, der sowohl für die Suche als auch für das Einfügen verwendet wird, falls nicht gefunden
hint - Iterator auf die Position, vor der das neue Element eingefügt wird
obj - der einzufügende oder zuzuweisende Wert

Rückgabewert

1-3) Die bool -Komponente ist true , wenn die Einfügung stattgefunden hat, und false , wenn die Zuweisung stattgefunden hat. Die Iterator-Komponente zeigt auf das Element, das eingefügt oder aktualisiert wurde.
4-6) Iterator, der auf das eingefügte oder aktualisierte Element zeigt.

Komplexität

1-3) Gleich wie für emplace .
4-6) Gleich wie für emplace_hint .

Hinweise

insert_or_assign liefert mehr Informationen als operator [ ] und erfordert keine Standardkonstruierbarkeit des zugeordneten Typs.

Feature-Test Makro Wert Std Feature
__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) Heterogene Überladungen für die verbleibenden Memberfunktionen in geordneten und ungeordneten assoziativen Containern . Überladungen ( 3 ) und ( 6 ) .

Beispiel

Diesen Code ausführen 
#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);
}

Ausgabe: 

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

Siehe auch

greift auf bestimmtes Element zu oder fügt es ein
(öffentliche Elementfunktion)
greift auf bestimmtes Element mit Grenzprüfung zu
(öffentliche Elementfunktion)
fügt Elemente ein oder Knoten (seit C++17)
(öffentliche Elementfunktion)
(C++11)
konstruiert Element direkt vor Ort
(öffentliche Elementfunktion)