WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::get_if: ausnahmefreie Variant-Prüfung

std::get_if liefert einen Zeiger auf die verlangte aktive std::variant-Alternative oder nullptr, ohne zu werfen.

Version: C++23

Syntax

template<std::size_t I, class... Types>
constexpr std::add_pointer_t<std::variant_alternative_t<I, std::variant<Types...>>>
std::get_if(std::variant<Types...>* v) noexcept;

template<class T, class... Types>
constexpr std::add_pointer_t<T>
std::get_if(std::variant<Types...>* v) noexcept;

// const-pointer overloads return pointers to const.

std::get_if<I>(&v) wählt per Index, std::get_if<T>(&v) einen genau einmal vorkommenden Typ. Ist der Variant-Zeiger nicht null und entspricht v.index() der Auswahl, zeigt das Ergebnis auf das gespeicherte Objekt; sonst ist es nullptr. Die Überladung für const std::variant* liefert einen Zeiger auf const.

Im Beispiel speichert der Variant den Integer 42. Der erste Aufruf liefert einen gültigen const int*, die Prüfung auf std::string dagegen nullptr; deshalb lautet die Ausgabe 42 1. Der Zeiger erlaubt den Zugriff ohne anschließendes std::get.

Der Index muss unter der Alternativenzahl liegen und der Typ genau einmal vorkommen. Ein Verstoß ist ein Compilezeitfehler, kein Nullergebnis. Die Funktion ist noexcept und akzeptiert auch einen nullen Variant-Zeiger. Der zurückgegebene Zeiger erlischt mit dem Variant oder nach einer Operation, die dessen aktive Alternative wechselt; Eigentum vermittelt er nicht.

Beispiele

#include <iostream>
#include <string>
#include <variant>

int main() {
    std::variant<int, std::string> value = 42;
    if (const int* number = std::get_if<int>(&value)) {
        std::cout << *number;
    }
    std::cout << ' ' << (std::get_if<std::string>(&value) == nullptr) << '\n';
}

Ergebnis

42 1

std::get_if → 42 1

Quellen