CKTIS / C++
Vinculação estruturada do resultado de `std::map::insert` (desde C++17)
Usa `auto [it, inserted]` para dar nomes ao iterador e ao indicador devolvidos por `std::map::insert` ao inserir um único valor sem uma indicação de posição.
Versão: ISO C++23; implementation support may vary
Sintaxe
auto [it, inserted] = m.insert(value); // C++17 and later; m is a std::map and value is a single elementDesde C++17, auto [it, inserted] = m.insert(value); dá um nome a cada componente do par devolvido. Os parênteses retos contêm identificadores, não tipos: escrever literalmente auto [iterator, bool] causa um erro de compilação porque bool é uma palavra reservada. Este par exige exatamente dois nomes, pela ordem indicada.
auto aplica-se a um objeto par oculto, não a duas declarações independentes. std::pair usa uma interface semelhante à de um tuplo: it designa a primeira componente (first) e inserted a segunda (second). Se já existir um par result, auto [it, inserted] = result; copia-o, ao passo que auto& [it, inserted] = result; associa os nomes às suas componentes. Não podes usar auto& diretamente com o resultado de insert, que é devolvido por valor.
A sobrecarga de std::map::insert que recebe um único valor sem indicação de posição devolve std::pair<iterator, bool>. Se a chamada terminar normalmente, inserted é true se foi inserido um elemento e false se já existia uma chave equivalente segundo o comparador. Em ambos os casos, it aponta para o elemento correspondente e it->second lê o seu valor armazenado. Um duplicado não substitui esse valor. false não indica uma exceção.
Nem todas as sobrecargas devolvem um par: a inserção de um valor com indicação de posição devolve apenas um iterador, a inserção de um intervalo devolve void e a inserção de um handle de nó sem indicação de posição devolve insert_return_type. O iterador não prolonga o tempo de vida do mapa nem do elemento. Outras inserções em std::map não o invalidam, mas não o uses após a remoção do elemento para o qual aponta ou a destruição do mapa.
Exemplos
#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';
}
}
Resultado
true 10 false 10
A primeira tentativa guarda `10` na chave `7`. A segunda usa a mesma chave e indica `false`; `it->second` continua a ser `10`, e não `20`.
Lições relacionadas
- C++ · Lição 26 · Intermédio · Versão: 2