CKTIS / C++
std::visit — appeler un objet appelable pour les alternatives actives
std::visit, déclaré dans <variant>, appelle un objet appelable en lui passant la valeur active de chaque objet std::variant fourni. Si aucune variante n’est fournie, std::visit(visitor) appelle visitor sans argument, à condition que cet appel soit valide. Les alternatives sont sélectionnées à l’exécution, mais la validité de l’appel est vérifiée à la compilation pour chaque combinaison d’alternatives.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <variant>
std::visit(visitor, variants...)
std::visit<R>(visitor, variants...)std::visit(visitor, variants...) de <variant> transmet les valeurs actives à visitor. Avec plusieurs variantes, il transmet une valeur de chacune. Il préserve la qualification const et la catégorie de valeur des arguments.
L’appel doit être valide pour chaque combinaison d’alternatives, et pas seulement pour la combinaison actuellement active. Sans R explicite, tous les résultats doivent avoir le même type et la même catégorie de valeur. La forme std::visit<R>(visitor, variants...) spécifie le type de résultat ; chaque appel doit satisfaire les exigences de conversion vers R, tandis que R = void écarte le résultat.
Si une variante est valueless_by_exception(), la fonction lance std::bad_variant_access. L’exemple utilise des surcharges de Describe qui renvoient std::string. La sortie attendue est int: 42, puis text: hello, chacun sur sa propre ligne.
Cette entrée traite de la fonction libre en C++23. L’adresse fournie mène à un projet de norme en évolution, et non à un document C++23 figé. Définir un indicateur du compilateur ne garantit pas le fonctionnement dans un environnement d’exécution de production.
Exemples
#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';
}
Résultat
int: 42 text: hello
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.