CKTIS / C++
std::holds_alternative: actief varianttype testen
std::holds_alternative<T> test zonder exceptie of std::variant nu zijn unieke T-alternatief bevat.
Versie: C++23
Syntax
template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;std::holds_alternative<T>(v) retourneert true als v.index() gelijk is aan de index van type T in de lijst. De functie is constexpr en noexcept en leest of kopieert de opgeslagen waarde niet. T moet precies eenmaal in Types... voorkomen.
In het voorbeeld is std::string actief. De test voor int is false en die voor std::string true, zodat normale bool-opmaak 0 1 print. Na een geslaagde test haal je de waarde op met std::get<T>, of direct een pointer met std::get_if<T>.
Een herhaald type, zoals in std::variant<int, int>, kan niet met holds_alternative<int> worden getest: het programma is ill-formed; onderscheid die alternatieven via index(). Een variant kan valueless_by_exception() zijn, waarna elke typetest false is. Losse test en latere mutatie vereisen gewone synchronisatie als threads het object delen.
Voorbeelden
#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';
}
Resultaat
0 1
std::holds_alternative → 0 1