CKTIS / C++
std::visit — ein Callable für aktive Alternativen aufrufen
std::visit aus <variant> ruft ein Callable mit dem aktiven Wert jedes übergebenen std::variant-Objekts auf. Ohne Varianten ruft std::visit(visitor) das Callable visitor ohne Argumente auf, sofern dieser Aufruf gültig ist. Die Auswahl der Alternativen erfolgt zur Laufzeit; ob der Aufruf für jede Kombination von Alternativen gültig ist, wird beim Kompilieren geprüft.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <variant>
std::visit(visitor, variants...)
std::visit<R>(visitor, variants...)std::visit(visitor, variants...) aus <variant> übergibt die aktiven Werte an visitor. Bei mehreren Varianten wird jeweils ein Wert aus jeder übergeben. Die const-Qualifizierung und Wertkategorie der Argumente bleiben erhalten.
Der Aufruf muss für jede Kombination von Alternativen gültig sein, nicht nur für die gerade aktive Kombination. Ohne explizites R müssen alle Ergebnisse denselben Typ und dieselbe Wertkategorie haben. Die Form std::visit<R>(visitor, variants...) gibt den Ergebnistyp vor; jeder Aufruf muss die Konversionsanforderungen für R erfüllen, während R = void das Ergebnis verwirft.
Wenn eine Variante valueless_by_exception() ist, wirft die Funktion std::bad_variant_access. Das Beispiel verwendet Describe-Überladungen, die std::string zurückgeben. Die erwartete Ausgabe lautet int: 42 und anschließend text: hello, jeweils in einer eigenen Zeile.
Dieser Eintrag behandelt die freie Funktion in C++23. Die angegebene Adresse verweist auf einen fortlaufend weiterentwickelten Standardentwurf, nicht auf ein eingefrorenes C++23-Dokument. Das Setzen eines Compiler-Flags bestätigt nicht den Betrieb in einer Produktionslaufzeitumgebung.
Beispiele
#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';
}
Ergebnis
int: 42 text: hello
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.