CKTIS / C++
std::variant — jeden z pevnej množiny alternatívnych typov
std::variant ukladá hodnotu jedného z alternatívnych typov určených parametrami šablóny a spravuje jej životnosť. Umožňuje modelovať údaje ako „číslo alebo text“ a bezpečne kontrolovať a spracovať aktívnu alternatívu.
Verzia: 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...> z <variant> predstavuje uzavretú množinu alternatívnych typov. Uložená hodnota je vnútri objektu; aktívna je vždy len jedna alternatíva, s výnimkou nižšie opísaného stavu bez hodnoty. Predvolená konštrukcia inicializuje prvú alternatívu hodnotou a vyžaduje, aby sa dala predvolene skonštruovať. Prvá alternatíva typu std::monostate môže predstavovať zámerne prázdny stav.
index() vracia index aktívnej alternatívy, počítaný od nuly. std::get<T>(value) vracia referenciu, ak je aktívna alternatíva typu T. Vyvolá std::bad_variant_access, ak je aktívna iná alternatíva alebo ak nie je aktívna žiadna. std::get_if<T>(&value) vracia ukazovateľ alebo nullptr bez vyvolania výnimky. Prístup podľa typu vyžaduje, aby sa daný typ v zozname alternatív vyskytoval presne raz; pri opakovaných typoch použite prístup podľa indexu, napríklad std::get<0>(value).
std::visit(visitor, value) zavolá volateľný objekt s aktívnou hodnotou. Objekt musí spracovať každú alternatívu; v zobrazenej forme volania musia mať všetky možné výsledky rovnaký typ a kategóriu hodnoty. Priradenie alebo emplace môže zmeniť aktívnu alternatívu. Výnimka počas niektorých takýchto operácií môže objekt ponechať bez hodnoty: vtedy valueless_by_exception() vracia true, index() vracia std::variant_npos a std::get aj std::visit vyvolajú std::bad_variant_access. To je iný stav než uchovávanie std::monostate.
Príklad najprv načíta int, potom ho nahradí typom std::string a hodnotu spracuje cez std::visit. Tento záznam je určený pre C++23; tento štandard vychádza z príznaku kompilátora v repozitári, nie z potvrdeného produkčného prostredia. Zdroj je priebežne sa meniaci pracovný návrh a môže obsahovať aj neskoršie funkcie.
Príklady
#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);
}
Výsledok
42 1 ready
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.