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