CKTIS / C++
std::variant — jeden z pevné množiny alternativních typů
std::variant ukládá hodnotu jednoho z alternativních typů určených parametry šablony a spravuje dobu její existence. Umožňuje modelovat data jako „číslo nebo text“ a bezpečně kontrolovat a zpracovávat aktivní alternativu.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <variant>
std::variant<Types...> value;
std::get<T>(value);
std::get_if<T>(&value);
std::visit(visitor, value);std::variant<Types...> z <variant> představuje uzavřenou množinu alternativních typů. Uložená hodnota je součástí objektu; aktivní je vždy jen jedna alternativa, s výjimkou níže popsaného stavu bez hodnoty. Výchozí konstrukce inicializuje první alternativu hodnotou a vyžaduje, aby ji bylo možné výchozím způsobem zkonstruovat. První alternativa typu std::monostate může představovat záměrně prázdný stav.
index() vrací index aktivní alternativy, počítaný od nuly. std::get<T>(value) vrací referenci, pokud je aktivní alternativa typu T. Vyvolá std::bad_variant_access, pokud je aktivní jiná alternativa nebo pokud není aktivní žádná. std::get_if<T>(&value) vrací ukazatel nebo nullptr, aniž by vyvolal výjimku. Přístup podle typu vyžaduje, aby se daný typ v seznamu alternativ vyskytoval právě jednou; při opakovaných typech použijte přístup podle indexu, například std::get<0>(value).
std::visit(visitor, value) zavolá volatelný objekt s aktivní hodnotou. Objekt musí obsloužit každou alternativu; v uvedené podobě volání musí mít všechny možné výsledky stejný typ i kategorii hodnoty. Přiřazení nebo emplace může změnit aktivní alternativu. Výjimka během některých takových operací může objekt ponechat bez hodnoty: pak valueless_by_exception() vrací true, index() vrací std::variant_npos a std::get i std::visit vyvolají std::bad_variant_access. To se liší od uložení std::monostate.
Příklad nejprve přečte int, poté jej nahradí typem std::string a hodnotu zpracuje pomocí std::visit. Tento záznam cílí na C++23; tento standard vychází z příznaku kompilátoru v repozitáři, nikoli z potvrzeného produkčního prostředí. Zdroj je průběžně upravovaný pracovní návrh a může obsahovat také pozdější funkce.
Pří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ýsledek
42 1 ready
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.