CKTIS / C++
std::holds_alternative: test aktywnego typu wariantu
std::holds_alternative<T> bezwyjątkowo sprawdza, czy std::variant przechowuje właśnie swoją jednoznaczną alternatywę T.
Wersja: C++23
Składnia
template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;std::holds_alternative<T>(v) zwraca true, gdy v.index() równa się indeksowi typu T na liście alternatyw. Funkcja jest constexpr i noexcept; nie odczytuje ani nie kopiuje przechowywanej wartości. Warunkiem poprawności deklaracji jest wystąpienie T dokładnie raz w Types....
W przykładzie aktywną alternatywą jest std::string. Test int daje false, a test std::string true, więc standardowe drukowanie bool wypisuje 0 1. Po udanym teście wartość można pobrać przez std::get<T> albo od razu uzyskać wskaźnik przez std::get_if<T>.
Powtórzony typ, np. std::variant<int, int>, nie może być testowany przez holds_alternative<int>: program jest źle sformułowany; wtedy rozróżniaj alternatywy przez index(). Wariant może być valueless_by_exception(), wtedy żaden test typu nie jest prawdziwy. Oddzielony test i późniejsza mutacja wymagają zwykłej synchronizacji, gdy obiekt jest współdzielony między wątkami.
Przykłady
#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';
}
Wynik
0 1
std::holds_alternative → 0 1