CKTIS / C++
Strukturierte Bindung des Ergebnisses von `std::map::insert` (seit C++17)
Mit `auto [it, inserted]` benennst du den Iterator und das Einfügekennzeichen, die `std::map::insert` beim Einfügen eines einzelnen Werts ohne Positionshinweis zurückgibt.
Version: ISO C++23; implementation support may vary
Syntax
auto [it, inserted] = m.insert(value); // C++17 and later; m is a std::map and value is a single elementSeit C++17 benennt auto [it, inserted] = m.insert(value); beide Bestandteile des zurückgegebenen Paars. In den eckigen Klammern stehen Bezeichner, keine Typen: Die wörtliche Schreibweise auto [iterator, bool] führt zu einem Kompilierfehler, weil bool ein Schlüsselwort ist. Dieses Paar verlangt genau zwei Namen in der angegebenen Reihenfolge.
auto gilt für ein verborgenes Paarobjekt, nicht für zwei unabhängige Deklarationen. std::pair wird über seine tupelartige Schnittstelle gebunden: it bezeichnet die erste Komponente (first), inserted die zweite (second). Bei einem vorhandenen Paar result kopiert auto [it, inserted] = result; das Paar, während auto& [it, inserted] = result; an seine Komponenten bindet. Für das direkt von insert als Wert zurückgegebene Ergebnis ist auto& nicht zulässig.
Die Überladung von std::map::insert für einen einzelnen Wert ohne Positionshinweis liefert std::pair<iterator, bool>. Bei normaler Rückkehr ist inserted gleich true, wenn ein Element eingefügt wurde, und false, wenn laut Vergleichsobjekt bereits ein gleichwertiger Schlüssel vorhanden war. In beiden Fällen zeigt it auf das entsprechende Element, und it->second liest dessen gespeicherten Wert. Ein Duplikat überschreibt diesen Wert nicht. false meldet keine Ausnahme.
Nicht jede Überladung liefert ein Paar: Das Einfügen eines Werts mit Positionshinweis gibt nur einen Iterator zurück, das Einfügen eines Bereichs gibt void zurück und das Einfügen eines Knoten-Handles ohne Positionshinweis liefert insert_return_type. Der Iterator verlängert weder die Lebensdauer der Map noch die des Elements. Weitere Einfügungen in std::map machen ihn nicht ungültig; verwende ihn aber nicht, nachdem das betreffende Element entfernt oder die Map zerstört wurde.
Beispiele
#include <iostream>
#include <map>
int main() {
std::map<int, int> m;
const int values[] = {10, 20};
for (int value : values) {
auto [it, inserted] = m.insert(std::map<int, int>::value_type{7, value});
std::cout << std::boolalpha << inserted << ' ' << it->second << '\n';
}
}
Ergebnis
true 10 false 10
Der erste Versuch speichert `10` unter Schlüssel `7`. Der zweite Versuch mit demselben Schlüssel meldet `false`; `it->second` ist weiterhin `10`, nicht `20`.
Zugehörige Lektionen
- C++ · Lektion 26 · Mittlere Stufe · Version: 2