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.