CKTIS / C++
std::variant — één van een vaste verzameling alternatieve typen
std::variant slaat een waarde op van een van de alternatieve typen die door de templateparameters zijn opgegeven en beheert de levensduur ervan. Zo kun je gegevens zoals ‘getal of tekst’ modelleren en de actieve variant veilig controleren en verwerken.
Versie: 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...> uit <variant> stelt een gesloten verzameling alternatieve typen voor. De opgeslagen waarde bevindt zich in het object; er is telkens maar één alternatief actief, behalve in de hieronder beschreven toestand zonder waarde. Standaardconstructie initialiseert het eerste alternatief met een waarde en vereist dat dit standaard geconstrueerd kan worden. Een eerste alternatief van het type std::monostate kan een bedoelde lege toestand voorstellen.
index() geeft de index van het actieve alternatief terug, beginnend bij nul. std::get<T>(value) geeft een referentie terug als het alternatief van het type T actief is. De functie gooit std::bad_variant_access als een ander alternatief actief is of als er geen alternatief actief is. std::get_if<T>(&value) geeft een pointer of nullptr terug, zonder een uitzondering te gooien. Toegang op type vereist dat dat type precies één keer in de lijst met alternatieven voorkomt; gebruik bij herhaalde typen toegang op index, zoals std::get<0>(value).
std::visit(visitor, value) roept een aanroepbaar object aan met de actieve waarde. Het object moet elk alternatief afhandelen; bij de getoonde aanroepvorm moeten alle mogelijke resultaten hetzelfde type en dezelfde waardecategorie hebben. Een toewijzing of emplace kan het actieve alternatief wijzigen. Een uitzondering tijdens sommige van deze bewerkingen kan het object zonder waarde achterlaten: dan geeft valueless_by_exception() true terug, geeft index() std::variant_npos terug en gooien zowel std::get als std::visit std::bad_variant_access. Dit verschilt van het bevatten van std::monostate.
Het voorbeeld leest eerst een int, vervangt die vervolgens door een std::string en verwerkt de waarde met std::visit. Dit item is bedoeld voor C++23; die standaard volgt uit de compileroptie van de repository en vormt geen bevestiging van een productieomgeving. De bron is een veranderende werkversie en kan ook latere functies bevatten.
Voorbeelden
#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);
}
Resultaat
42 1 ready
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.