Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / C++

std::get_if: consulta de variant sin excepciones

std::get_if devuelve un puntero a la alternativa activa solicitada de std::variant o nullptr sin lanzar.

Versión: C++23

Sintaxis

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) selecciona por índice, mientras std::get_if<T>(&v) selecciona un tipo que aparece exactamente una vez. Si el puntero al variant no es nulo y v.index() coincide, el resultado apunta al objeto almacenado; en otro caso es nullptr. La sobrecarga para const std::variant* devuelve puntero a const.

En el ejemplo el variant almacena el entero 42. La primera llamada obtiene un const int* válido y consultar std::string obtiene nullptr; por eso imprime 42 1. El puntero permite inspeccionar sin una segunda llamada a std::get.

El índice debe ser menor que el número de alternativas y el tipo debe aparecer exactamente una vez. Incumplirlo es error de compilación, no resultado nulo. La función es noexcept y también acepta un puntero nulo al variant. El puntero devuelto caduca con el variant o al cambiar su alternativa activa; no es propietario.

Ejemplos

#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

Fuentes