CKTIS / C++
std::holds_alternative: testar o tipo ativo de um variant
std::holds_alternative<T> testa sem exceções se std::variant guarda atualmente a sua alternativa T única.
Versão: C++23
Sintaxe
template<class T, class... Types>
constexpr bool
std::holds_alternative(const std::variant<Types...>& value) noexcept;std::holds_alternative<T>(v) devolve true quando v.index() coincide com o índice do tipo T na lista. É constexpr e noexcept e não lê nem copia o valor guardado. A declaração exige que T ocorra exatamente uma vez em Types....
No exemplo está ativo std::string. Testar int dá false e testar std::string dá true, portanto a formatação bool normal imprime 0 1. Depois de um teste positivo, obtém o valor com std::get<T> ou diretamente um ponteiro com std::get_if<T>.
Um tipo repetido, como em std::variant<int, int>, não pode ser testado com holds_alternative<int>: o programa é mal formado; distingue essas alternativas por index(). Um variant pode estar valueless_by_exception(), caso em que todos os testes são false. Teste separado e mutação requerem sincronização normal quando o objeto é partilhado entre threads.
Exemplos
#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';
}
Resultado
0 1
std::holds_alternative → 0 1