CKTIS / C++
std::variant — einer aus einer festen Menge von Alternativtypen
std::variant speichert einen Wert aus den durch seine Template-Parameter festgelegten Alternativen und verwaltet dessen Lebensdauer. Damit lassen sich Daten wie „Zahl oder Text“ modellieren und die aktive Alternative sicher prüfen und behandeln.
Version: C++23; repository compiler flag, production runtime not attested
Syntax
#include <variant>
std::variant<Types...> value;
std::get<T>(value);
std::get_if<T>(&value);
std::visit(visitor, value);std::variant<Types...> aus <variant> repräsentiert eine geschlossene Menge von Alternativtypen. Der enthaltene Wert liegt im Objekt; jeweils ist nur eine Alternative aktiv, außer im weiter unten beschriebenen wertlosen Zustand. Die Standardkonstruktion initialisiert die erste Alternative mit einem Wert und setzt voraus, dass sie standardmäßig konstruierbar ist. Eine erste Alternative vom Typ std::monostate kann einen absichtlich leeren Zustand darstellen.
index() gibt den nullbasierten Index der aktiven Alternative zurück. std::get<T>(value) gibt eine Referenz zurück, wenn die Alternative vom Typ T aktiv ist. Ist eine andere oder gar keine Alternative aktiv, wirft die Funktion std::bad_variant_access. std::get_if<T>(&value) gibt einen Zeiger oder nullptr zurück, ohne eine Ausnahme zu werfen. Beim typbasierten Zugriff muss der Typ genau einmal in der Liste der Alternativen vorkommen; bei mehrfach vorkommenden Typen ist ein indexbasierter Zugriff wie std::get<0>(value) zu verwenden.
std::visit(visitor, value) ruft ein aufrufbares Objekt mit dem aktiven Wert auf. Das Objekt muss jede Alternative behandeln; bei der gezeigten Aufrufform müssen alle möglichen Ergebnisse denselben Typ und dieselbe Wertkategorie haben. Eine Zuweisung oder emplace kann die aktive Alternative ändern. Eine Ausnahme während einiger solcher Operationen kann dazu führen, dass das Objekt keinen Wert mehr hat: Dann gibt valueless_by_exception() true zurück, index() gibt std::variant_npos zurück und sowohl std::get als auch std::visit werfen std::bad_variant_access. Das ist nicht dasselbe wie das Speichern von std::monostate.
Das Beispiel liest zunächst ein int, ersetzt es dann durch einen std::string und verarbeitet den Wert mit std::visit. Dieser Eintrag zielt auf C++23 ab; dieser Standard ergibt sich aus der Compiler-Option des Repositorys und bestätigt keine Produktionslaufzeit. Die Quelle ist ein sich weiterentwickelnder Arbeitsentwurf und kann auch spätere Funktionen enthalten.
Beispiele
#include <iostream>
#include <string>
#include <variant>
int main() {
std::variant<int, std::string> value{42};
if (const auto* number = std::get_if<int>(&value)) {
std::cout << *number << '\n';
}
value = std::string{"ready"};
std::cout << value.index() << '\n';
std::visit([](const auto& item) {
std::cout << item << '\n';
}, value);
}
Ergebnis
42 1 ready
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.