CKTIS / C++
std::holds_alternative: preizkus aktivnega tipa varianta
std::holds_alternative<T> brez izjeme preveri, ali std::variant trenutno hrani svojo enolično alternativo T.
Različica: C++23
Sintaksa
template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;std::holds_alternative<T>(v) vrne true, ko je v.index() enak indeksu tipa T v seznamu. Funkcija je constexpr in noexcept ter vrednosti ne bere ali kopira. Deklaracija zahteva, da se T v Types... pojavi natanko enkrat.
V primeru je aktiven std::string. Preizkus int je false, std::string pa true, zato običajen izpis bool izpiše 0 1. Po uspešnem testu pridobi vrednost s std::get<T> ali neposredno kazalec s std::get_if<T>.
Ponovljenega tipa, kot v std::variant<int, int>, ni mogoče testirati s holds_alternative<int>: program ni pravilno oblikovan; alternative loči z index(). Variant je lahko valueless_by_exception(), ko je vsak tipski test false. Ločen test in poznejša sprememba pri deljenju med nitmi zahtevata običajno sinhronizacijo.
Primeri
#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';
}
Rezultat
0 1
std::holds_alternative → 0 1