CKTIS / C++
Liaison structurée du résultat de `std::map::insert` (depuis C++17)
Utilisez `auto [it, inserted]` pour nommer l’itérateur et l’indicateur renvoyés par `std::map::insert` lors de l’insertion d’une seule valeur sans indication de position.
Version : ISO C++23; implementation support may vary
Syntaxe
auto [it, inserted] = m.insert(value); // C++17 and later; m is a std::map and value is a single elementDepuis C++17, auto [it, inserted] = m.insert(value); nomme les deux composantes de la paire renvoyée. Les crochets contiennent des identifiants, pas des types : écrire littéralement auto [iterator, bool] provoque une erreur de compilation, car bool est un mot-clé. Cette paire exige exactement deux noms, dans l’ordre indiqué.
auto s’applique à un objet paire caché, et non à deux déclarations indépendantes. std::pair utilise son interface de type tuple : it désigne la première composante (first) et inserted la seconde (second). Pour une paire existante result, auto [it, inserted] = result; la copie, tandis que auto& [it, inserted] = result; lie les noms à ses composantes. On ne peut pas employer auto& directement sur le résultat renvoyé par valeur par insert.
La surcharge de std::map::insert qui reçoit une seule valeur sans indication de position renvoie std::pair<iterator, bool>. Si l’appel se termine normalement, inserted vaut true si un élément a été ajouté, et false si une clé équivalente selon le comparateur existait déjà. Dans les deux cas, it pointe vers l’élément correspondant et it->second lit la valeur stockée. Un doublon ne remplace pas cette valeur. false ne signale pas une exception.
Toutes les surcharges ne renvoient pas une paire : l’insertion d’une valeur avec indication de position renvoie seulement un itérateur, celle d’une plage renvoie void, et celle d’un handle de nœud sans indication de position renvoie insert_return_type. L’itérateur ne prolonge ni la durée de vie de la map ni celle de l’élément. D’autres insertions dans std::map ne l’invalident pas, mais ne l’utilisez pas après la suppression de l’élément pointé ou la destruction de la map.
Exemples
#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';
}
}
Résultat
true 10 false 10
La première tentative stocke `10` à la clé `7`. La seconde utilise la même clé et indique `false` ; `it->second` vaut toujours `10`, et non `20`.
Leçons associées
- C++ · Leçon 26 · Intermédiaire · Version : 2