Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::variant — jedna z ustalonych alternatyw typów

std::variant przechowuje wartość jednej z alternatyw określonych w parametrach szablonu i zarządza jej czasem życia. Pozwala modelować dane typu „liczba albo tekst” oraz bezpiecznie sprawdzać i obsługiwać aktywną alternatywę.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <variant>
std::variant<Types...> value;
std::get<T>(value);
std::get_if<T>(&value);
std::visit(visitor, value);

std::variant<Types...> z nagłówka <variant> reprezentuje zamknięty zestaw alternatyw typów. Przechowywana wartość znajduje się wewnątrz obiektu; aktywna jest tylko jedna alternatywa naraz, z wyjątkiem stanu bez wartości opisanego poniżej. Domyślna konstrukcja inicjalizuje wartością pierwszą alternatywę i wymaga, aby można ją było skonstruować domyślnie. std::monostate jako pierwsza alternatywa może reprezentować zamierzony stan pusty.

index() zwraca indeks aktywnej alternatywy, liczony od zera. std::get<T>(value) zwraca referencję, jeśli aktywna jest alternatywa typu T. Zgłasza std::bad_variant_access, gdy aktywna jest inna alternatywa lub gdy żadna alternatywa nie jest aktywna. std::get_if<T>(&value) zwraca wskaźnik lub nullptr, bez zgłaszania wyjątku. Dostęp przez typ wymaga jego dokładnie jednego wystąpienia w liście alternatyw; przy powtórzonych typach użyj dostępu przez indeks, np. std::get<0>(value).

std::visit(visitor, value) wywołuje obiekt wywoływalny dla aktywnej wartości. Musi on obsługiwać każdą alternatywę; w pokazanej postaci wywołania wszystkie możliwe wyniki muszą mieć ten sam typ i kategorię wartości. Przypisanie lub emplace może zmienić aktywną alternatywę. Wyjątek podczas niektórych takich operacji może pozostawić obiekt bez wartości: wtedy valueless_by_exception() zwraca true, index() zwraca std::variant_npos, a zarówno std::get, jak i std::visit zgłaszają std::bad_variant_access. To inny stan niż przechowywanie std::monostate.

Przykład najpierw odczytuje int, następnie zastępuje go przez std::string i obsługuje wartość przez std::visit. Wpis dotyczy C++23; podany standard wynika z flagi kompilatora repozytorium, nie z potwierdzenia środowiska produkcyjnego. Źródło jest rozwijanym szkicem i może zawierać także późniejsze funkcje.

Przykłady

#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);
}

Wynik

42
1
ready

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła