Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::holds_alternative: testare il tipo attivo di un variant

std::holds_alternative<T> verifica senza eccezioni se std::variant contiene la propria alternativa T univoca.

Versione: C++23

Sintassi

template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;

std::holds_alternative<T>(v) restituisce true quando v.index() coincide con l’indice del tipo T nell’elenco. È constexpr e noexcept e non legge né copia il valore. La dichiarazione richiede che T compaia esattamente una volta in Types....

Nell’esempio è attivo std::string. Il test di int è false e quello di std::string true, quindi la normale formattazione bool stampa 0 1. Dopo un test riuscito, ottieni il valore con std::get<T> o direttamente un puntatore con std::get_if<T>.

Un tipo ripetuto, come in std::variant<int, int>, non può essere testato con holds_alternative<int>: il programma è ill-formed; distingui tali alternative con index(). Un variant può essere valueless_by_exception(), e allora ogni test è false. Test separato e mutazione richiedono normale sincronizzazione se l’oggetto è condiviso tra thread.

Esempi

#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';
}

Risultato

0 1

std::holds_alternative → 0 1

Fonti