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

CKTIS / C++

std::visit — invocar um callable para as alternativas ativas

std::visit, declarada em <variant>, invoca um callable com o valor ativo de cada objeto std::variant fornecido. Se não for fornecida nenhuma variante, std::visit(visitor) invoca visitor sem argumentos, desde que essa invocação seja válida. As alternativas são selecionadas em tempo de execução, mas a validade da invocação é verificada em tempo de compilação para cada combinação de alternativas.

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

Sintaxe

#include <variant>
std::visit(visitor, variants...)
std::visit<R>(visitor, variants...)

std::visit(visitor, variants...), de <variant>, passa os valores ativos a visitor. Com várias variantes, passa um valor de cada uma. Preserva a qualificação const e a categoria de valor dos argumentos.

A invocação tem de ser válida para todas as combinações de alternativas, não apenas para a combinação atualmente ativa. Sem especificar R, todos os resultados têm de ter o mesmo tipo e a mesma categoria de valor. A forma std::visit<R>(visitor, variants...) especifica o tipo do resultado; cada invocação tem de cumprir os requisitos de conversão para R, enquanto R = void descarta o resultado.

Se alguma variante estiver em estado valueless_by_exception(), a função lança std::bad_variant_access. O exemplo utiliza overloads de Describe que devolvem std::string. O resultado esperado é int: 42, seguido de text: hello, cada um numa linha própria.

Esta entrada abrange a função livre em C++23. O endereço indicado aponta para um projeto de norma em evolução, não para um documento C++23 definitivo. Definir uma opção do compilador não atesta o funcionamento num ambiente de execução de produção.

Exemplos

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

struct Describe {
    std::string operator()(int value) const {
        return "int: " + std::to_string(value);
    }
    std::string operator()(const std::string& value) const {
        return "text: " + value;
    }
};

int main() {
    std::variant<int, std::string> value{42};
    std::cout << std::visit(Describe{}, value) << '\n';
    value = std::string{"hello"};
    std::cout << std::visit(Describe{}, value) << '\n';
}

Resultado

int: 42
text: hello

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