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

CKTIS / C++

std::tuple — um tuplo de elementos com tipos fixos

std::tuple de <tuple> agrupa um número fixo de elementos cujos tipos podem ser diferentes. std::get permite aceder aos elementos, enquanto as ligações estruturadas lhes atribuem nomes locais.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <tuple>
std::tuple<Types...> name{values...};
std::get<I>(name);
std::get<T>(name);

std::tuple<Types...> de <tuple> armazena um número fixo de elementos. Cada argumento de modelo especifica o tipo de uma posição; os tipos podem repetir-se ou ser diferentes. O número e os tipos das posições ficam fixos em tempo de compilação, mas os valores podem mudar se os respetivos tipos e qualificadores o permitirem.

std::get<I>(t) devolve uma referência ao elemento no índice I, contado a partir de zero. O índice tem de ser uma constante em tempo de compilação e estar dentro do intervalo; um índice inválido provoca um erro de compilação, não uma exceção. std::get<T>(t) seleciona um elemento pelo tipo, mas exige que T apareça exatamente uma vez.

No exemplo, std::get<0>(item) altera o primeiro elemento de 3 para 5. A declaração auto& [count, label] = item; introduz nomes que se referem aos elementos do tuplo original. Em contrapartida, neste exemplo, auto [count, label] = item; criaria uma cópia do tuplo e ligaria os nomes aos respetivos elementos.

O exemplo destina-se a ser compilado com -std=c++23. O código apresentado foi executado sem alterações num ambiente isolado e verificou-se que a saída padrão correspondia exatamente à saída indicada. Esta verificação não atesta o ambiente de execução em produção. A fonte eel.is é um projeto de norma em evolução, não uma publicação C++23 imutável; esta explicação limita-se às funcionalidades disponíveis em C++23.

Exemplos

#include <iostream>
#include <tuple>

int main() {
    std::tuple<int, char> item{3, 'A'};
    std::get<0>(item) += 2;
    auto& [count, label] = item;
    std::cout << count << ' ' << label << '\n';
}

Resultado

5 A

O código apresentado foi executado sem alterações num ambiente isolado. A saída padrão correspondeu exatamente à saída indicada.

Fontes