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

CKTIS / C++

Ligações estruturadas com `auto [a, b, c]` em C++

Uma ligação estruturada dá nomes aos componentes de um único objeto. `auto`, `auto&` e `const auto&` determinam como esse objeto é armazenado ou referenciado.

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

Sintaxe

auto [a, b, c] = expression;
auto& [a, b, c] = lvalue;
const auto& [a, b, c] = expression;

auto [a, b, c] = expression; introduz três nomes novos no âmbito atual. A parte antes de [ aplica-se a uma única variável oculta, não a três declarações auto independentes. A sintaxe existe desde C++17. Esta ficha abrange ISO C++23; o suporte pode variar consoante a implementação.

Os arrays nativos são decompostos por índice. Os tipos semelhantes a tuplos, como std::tuple, std::pair e std::array, são decompostos por posição segundo o seu protocolo de tuplo. Nas restantes classes que cumprem os requisitos, são ligados todos os membros de dados não estáticos, pela ordem de declaração. Esses membros têm de pertencer todos diretamente à classe ou todos a uma mesma classe base. Cada membro tem de estar acessível no contexto da declaração da ligação estruturada: um membro inacessível não é ignorado e torna a declaração inválida. Em C++23, o número de nomes tem de corresponder ao número de componentes: std::pair exige dois, não três.

Para um tuplo com nome que guarda valores, auto cria uma cópia oculta e auto& liga-se aos elementos originais. Escrever através de uma ligação altera, nesse caso, o original. const auto& permite ler os elementos comuns armazenados por valor sem copiar o tuplo. Uma ligação direta a um tuplo temporário pode prolongar a sua duração de vida até ao fim da duração de vida da referência oculta. Os elementos de tipo referência, como os produzidos por std::tie, continuam a referir-se aos mesmos objetos mesmo com auto; a ligação não prolonga a duração de vida desses objetos.

std::get<0>(t) devolve uma referência ao primeiro elemento do tuplo t sem declarar um nome. std::tie(u, v, w) = t; atribui valores a variáveis existentes através de um tuplo de referências. Já uma ligação estruturada introduz nomes novos.

Exemplos

#include <iostream>
#include <tuple>

int main() {
    std::tuple<int, int, int> values{1, 2, 3};

    auto [a, b, c] = values;
    a = 9;
    std::cout << a << ' ' << std::get<0>(values) << '\n';

    auto& [x, y, z] = values;
    x = 7;
    std::cout << x << ' ' << std::get<0>(values) << '\n';
}

Resultado

9 1
7 7

A primeira linha (`9 1`) mostra a alteração da cópia; a segunda (`7 7`) mostra que `x` altera o tuplo original.

Lições relacionadas

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

Fontes