Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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

Fontes