Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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

Sources