Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje