CKTIS / C++
std::holds_alternative: test aktivního typu variantu
std::holds_alternative<T> bez výjimky testuje, zda std::variant právě ukládá svou jednoznačnou alternativu T.
Verze: C++23
Syntaxe
template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;std::holds_alternative<T>(v) vrací true, když v.index() odpovídá indexu typu T v seznamu alternativ. Je constexpr a noexcept a uloženou hodnotu nečte ani nekopíruje. Deklarace vyžaduje, aby se T v Types... vyskytoval právě jednou.
V příkladu je aktivní std::string. Test int je false a test std::string true, takže běžný výpis bool zobrazí 0 1. Po úspěšném testu získáte hodnotu pomocí std::get<T> nebo přímo ukazatel přes std::get_if<T>.
Opakovaný typ, například ve std::variant<int, int>, nelze testovat pomocí holds_alternative<int>: program je chybný; alternativy rozlište přes index(). Variant může být valueless_by_exception(), pak jsou všechny typové testy false. Oddělený test a následná změna vyžadují běžnou synchronizaci mezi vlákny.
Příklady
#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';
}
Výsledek
0 1
std::holds_alternative → 0 1