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

CKTIS / C++

Ligação estruturada `const auto& [id, cand]` num ciclo `for` baseado num intervalo

Dá nomes distintos à chave e ao valor do elemento atual de `std::map` para os leres num ciclo `for` sem copiar o par.

Versão: ISO C++23; implementation support may vary

Sintaxe

for (const auto& [id, cand] : candidates) {
    // Use id and cand for the current element.
}

Em for (const auto& [id, cand] : candidates), os dois-pontos separam a declaração do intervalo. Em cada iteração, a declaração é inicializada com o elemento obtido ao desreferenciar o iterador atual. Um elemento de std::map<Key, T> é um std::pair<const Key, T>. O par exige dois nomes: id designa first (a chave) e cand designa second (o valor associado). O que conta é a posição, não a grafia dos nomes.

auto permite que o compilador deduza o tipo. const auto& liga uma referência lvalue implícita ao par atual como const, sem o copiar. Neste exemplo não é possível atribuir um novo valor através de id ou de cand; o mapa em si não passa a ser const.

Para este mapa, auto [id, cand] copia o par em cada iteração, pelo que alterar cand só afeta a cópia. Num mapa não constante, auto& [id, cand] permite alterar o valor associado através de cand, mas a chave continua a ser const. O âmbito dos nomes limita-se à iteração atual. Não uses uma referência guardada a um componente depois de removeres o elemento ou de o mapa ser destruído.

Esta sintaxe está disponível desde C++17 e é válida em ISO C++23. O suporte pode depender da implementação e do modo de compilação selecionado.

Exemplos

#include <iostream>
#include <map>
#include <string>

int main() {
    std::map<int, std::string> candidates{{42, "Mira"}, {7, "Lena"}};

    for (const auto& [id, cand] : candidates) {
        std::cout << id << ": " << cand << '\n';
    }
}

Resultado

7: Lena
42: Mira

O comparador predefinido de `std::map<int, std::string>` ordena as chaves por ordem numérica crescente. Por isso, `7: Lena` aparece antes de `42: Mira`, embora `42` esteja em primeiro lugar no inicializador.

Lições relacionadas

  • C++ · Lição 62 · Intermédio · Versão: 2

Fontes