CKTIS / C++
std::holds_alternative : tester le type actif d’un variant
std::holds_alternative<T> teste sans exception si std::variant stocke actuellement son unique alternative T.
Version : C++23
Syntaxe
template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;std::holds_alternative<T>(v) renvoie true lorsque v.index() égale l’indice du type T dans la liste. Elle est constexpr et noexcept et ne lit ni ne copie la valeur stockée. La déclaration exige que T apparaisse exactement une fois dans Types....
Dans l’exemple, std::string est actif. Le test de int est faux et celui de std::string vrai ; le formatage bool ordinaire affiche donc 0 1. Après un test réussi, récupérez la valeur avec std::get<T> ou directement un pointeur avec std::get_if<T>.
Un type répété, comme dans std::variant<int, int>, ne peut pas être testé par holds_alternative<int> : le programme est mal formé ; distinguez ces alternatives par index(). Un variant peut être valueless_by_exception(), alors tout test de type est faux. Test séparé puis mutation nécessitent une synchronisation normale si l’objet est partagé entre threads.
Exemples
#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';
}
Résultat
0 1
std::holds_alternative → 0 1