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

CKTIS / C++

std::variant — um de um conjunto fixo de tipos alternativos

std::variant armazena um valor de um dos tipos alternativos especificados pelos parâmetros do modelo e gere o tempo de vida desse valor. Permite modelar dados como «número ou texto» e verificar e tratar com segurança a alternativa ativa.

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

Sintaxe

#include <variant>
std::variant<Types...> value;
std::get<T>(value);
std::get_if<T>(&value);
std::visit(visitor, value);

std::variant<Types...> de <variant> representa um conjunto fechado de tipos alternativos. O valor contido está dentro do objeto; apenas uma alternativa está ativa de cada vez, exceto no estado sem valor descrito abaixo. A construção por omissão inicializa a primeira alternativa com um valor e exige que esta possa ser construída por omissão. Uma primeira alternativa do tipo std::monostate pode representar um estado vazio intencional.

index() devolve o índice, começando em zero, da alternativa ativa. std::get<T>(value) devolve uma referência se a alternativa do tipo T estiver ativa. Lança std::bad_variant_access se estiver ativa outra alternativa ou se não houver nenhuma alternativa ativa. std::get_if<T>(&value) devolve um ponteiro ou nullptr, sem lançar exceções. O acesso por tipo exige que esse tipo apareça exatamente uma vez na lista de alternativas; para tipos repetidos, usa o acesso por índice, como std::get<0>(value).

std::visit(visitor, value) invoca um objeto invocável com o valor ativo. O objeto tem de tratar todas as alternativas; na forma de chamada apresentada, todos os resultados possíveis têm de ter o mesmo tipo e a mesma categoria de valor. Uma atribuição ou emplace pode alterar a alternativa ativa. Uma exceção durante algumas destas operações pode deixar o objeto sem valor: nesse caso, valueless_by_exception() devolve true, index() devolve std::variant_npos e tanto std::get como std::visit lançam std::bad_variant_access. Este estado é diferente de armazenar std::monostate.

O exemplo lê primeiro um int, substitui-o depois por um std::string e trata o valor através de std::visit. Esta entrada destina-se a C++23; essa norma reflete a opção do compilador do repositório, não um ambiente de produção atestado. A fonte é um rascunho de trabalho em evolução e pode também conter funcionalidades posteriores.

Exemplos

#include <iostream>
#include <string>
#include <variant>

int main() {
    std::variant<int, std::string> value{42};
    if (const auto* number = std::get_if<int>(&value)) {
        std::cout << *number << '\n';
    }

    value = std::string{"ready"};
    std::cout << value.index() << '\n';
    std::visit([](const auto& item) {
        std::cout << item << '\n';
    }, value);
}

Resultado

42
1
ready

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes