Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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 element

Desde 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

Fontes