Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

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.

Zdroje