WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::holds_alternative: aktiven Variant-Typ prüfen

std::holds_alternative<T> prüft ohne Ausnahme, ob std::variant gerade seine eindeutige Alternative T speichert.

Version: C++23

Syntax

template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;

std::holds_alternative<T>(v) liefert true, wenn v.index() dem Index des Typs T in der Alternativenliste entspricht. Die Funktion ist constexpr und noexcept und liest oder kopiert den Wert nicht. T muss in Types... genau einmal vorkommen.

Im Beispiel ist std::string aktiv. Der Test auf int ist false, der auf std::string true, sodass die normale Bool-Ausgabe 0 1 lautet. Nach erfolgreichem Test kann std::get<T> den Wert oder std::get_if<T> direkt einen Zeiger liefern.

Ein wiederholter Typ wie in std::variant<int, int> kann nicht mit holds_alternative<int> getestet werden: Das Programm ist nicht wohlgeformt; unterscheide solche Alternativen mit index(). Ein Variant kann valueless_by_exception() sein, dann ist jeder Typtest false. Bei threadübergreifend geteilten Objekten brauchen getrennter Test und Mutation normale Synchronisation.

Beispiele

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

int main() {
    std::variant<int, std::string> state = std::string{"ready"};
    std::cout << std::holds_alternative<int>(state) << ' '
              << std::holds_alternative<std::string>(state) << '\n';
}

Ergebnis

0 1

std::holds_alternative → 0 1

Quellen