CKTIS / C++
std::get_if: consulta de variant sem exceções
std::get_if devolve um ponteiro para a alternativa ativa pedida de std::variant ou nullptr sem lançar.
Versão: C++23
Sintaxe
template<std::size_t I, class... Types>
constexpr std::add_pointer_t<std::variant_alternative_t<I, std::variant<Types...>>>
std::get_if(std::variant<Types...>* v) noexcept;
template<class T, class... Types>
constexpr std::add_pointer_t<T>
std::get_if(std::variant<Types...>* v) noexcept;
// const-pointer overloads return pointers to const.std::get_if<I>(&v) seleciona por índice, enquanto std::get_if<T>(&v) escolhe um tipo que ocorre exatamente uma vez. Se o ponteiro para o variant não for null e v.index() coincidir, o resultado aponta para o objeto guardado; caso contrário é nullptr. O overload para const std::variant* devolve ponteiro para const.
No exemplo o variant guarda o inteiro 42. A primeira chamada produz um const int* válido e procurar std::string produz nullptr; por isso imprime 42 1. O ponteiro permite aceder sem uma segunda chamada a std::get.
O índice tem de ser inferior ao número de alternativas e o tipo ocorrer exatamente uma vez. Violar isso é erro de compilação, não resultado null. A função é noexcept e aceita também ponteiro null para o variant. O ponteiro devolvido expira com o variant ou quando muda a alternativa ativa; não possui o objeto.
Exemplos
#include <iostream>
#include <string>
#include <variant>
int main() {
std::variant<int, std::string> value = 42;
if (const int* number = std::get_if<int>(&value)) {
std::cout << *number;
}
std::cout << ' ' << (std::get_if<std::string>(&value) == nullptr) << '\n';
}
Resultado
42 1
std::get_if → 42 1