Namespaces
Variants

    std::variant<Types...>::visit

    De fr.cppreference.net
     
    C++
    Support du compilateur
    Autonome et hébergé
    Langage
    Bibliothèque standard
    En-têtes de la bibliothèque standard
    Exigences nommées
    Macros de test de fonctionnalités (C++20)
    Bibliothèque de support du langage
    Bibliothèque de concepts (C++20)
    Bibliothèque de diagnostic
    Bibliothèque de gestion de la mémoire
    Bibliothèque de métaprogrammation (C++11)
    Bibliothèque d'utilitaires généraux
    Bibliothèque de conteneurs
    Bibliothèque d'itérateurs
    Bibliothèque de plages (C++20)
    Bibliothèque d'algorithmes
    Bibliothèque de chaînes
    Bibliothèque de traitement de texte
    Bibliothèque numérique
    Bibliothèque de date et d'heure
    Bibliothèque d'entrée/sortie
    Bibliothèque du système de fichiers (C++17)
    Bibliothèque de support de la concurrence (C++11)
    Bibliothèque de contrôle d'exécution (C++26)
    Spécifications techniques
    Index des symboles
    Bibliothèques externes
     
    Bibliothèque d'utilitaires
    Support du langage
    Support des types (types de base, RTTI)
    Macros de test de fonctionnalités de la bibliothèque (C++20)
    Utilitaires de programme
    Fonctions variadiques
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Support des coroutines (C++20)
    Support des contrats (C++26)
    Comparaison à trois voies
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    Utilitaires généraux
    Opérateurs relationnels (déprécié en C++20)
     
    std::variant
     
    template< class Self, class Visitor >
constexpr decltype(auto) visit( this Self&& self, Visitor&& vis );
    		(1) (depuis C++26) 
    template< class R, class Self, class Visitor >
constexpr R visit( this Self&& self, Visitor&& vis );
    		(2) (depuis C++26)

    Applique le visiteur vis (un Callable pouvant être appelé avec n'importe quelle combinaison de types du variant) au variant contenu par self.

    Étant donné le type V comme decltype(std::forward_like<Self>(std::declval<variant>())), l'appel équivalent est :

    1) return std::visit(std::forward<Visitor>(vis), (V) self);.
    2) return std::visit<R>(std::forward<Visitor>(vis), (V) self);.

    Paramètres

    vis - un Callable qui accepte chaque alternative possible de la variante
    self - variante à passer au visiteur

    Valeur de retour

    1) Le résultat de l'invocation std :: visit .
    2) Rien si R est (éventuellement qualifié cv) void ; sinon le résultat de l'invocation std :: visit < R > .

    Exceptions

    Ne lance que si l'appel à std :: visit lance.

    Notes

    Macro de test de fonctionnalité Valeur Std Fonctionnalité
    __cpp_lib_variant 202306L (C++26) membre visit

    Exemple

    Exécuter ce code 
    #include <print>
#include <string>
#include <string_view>
#include <variant>
struct Base {};
struct Derived : Base {};
// type d'assistance pour le visiteur
template<class... Ts>
struct overloads : Ts... { using Ts::operator()...; };
// le variant à visiter
using var_t = std::variant<int, std::string, Derived>;
int main()
{
    const auto visitor = overloads
    {
        [](int i){ std::print("int = {}\n", i); },
        [](std::string_view s){ std::println("string = “{}”", s); },
        [](const Base&){ std::println("base"); }
    };
    const var_t var1 = 42, var2 = "abc", var3 = Derived();
#if (__cpp_lib_variant >= 202306L)
    var1.visit(visitor);
    var2.visit(visitor);
    var3.visit(visitor);
#else
    std::visit(visitor, var1);
    std::visit(visitor, var2);
    std::visit(visitor, var3);
#endif
}

    Sortie : 

    int = 42
string = “abc”
base

    Voir aussi

    (C++17)
    		appelle le foncteur fourni avec les arguments contenus dans un ou plusieurs variant s
    (modèle de fonction)