CKTIS / C++
std::holds_alternative: test aktivnog tipa varianta
std::holds_alternative<T> bez iznimke provjerava sprema li std::variant upravo svoju jedinstvenu alternativu T.
Verzija: C++23
Sintaksa
template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;std::holds_alternative<T>(v) vraća true kada v.index() odgovara indeksu tipa T u popisu alternativa. Funkcija je constexpr i noexcept te ne čita ni kopira spremljenu vrijednost. Deklaracija zahtijeva da se T u Types... pojavi točno jednom.
U primjeru je aktivan std::string. Test int je false, a test std::string true, pa uobičajeni ispis bool daje 0 1. Nakon uspješnog testa vrijednost uzmi s std::get<T> ili izravno pokazivač s std::get_if<T>.
Ponovljeni tip, kao u std::variant<int, int>, ne može se testirati s holds_alternative<int>: program je neispravan; alternative razlikuj s index(). Variant može biti valueless_by_exception(), kada su svi testovi false. Odvojeni test i kasnija promjena pri dijeljenju među dretvama traže uobičajenu sinkronizaciju.
Primjeri
#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