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

CKTIS / C++

std::holds_alternative: probar el tipo activo de un variant

std::holds_alternative<T> comprueba sin excepciones si std::variant almacena ahora su alternativa T única.

Versión: C++23

Sintaxis

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

std::holds_alternative<T>(v) devuelve true cuando v.index() coincide con el índice del tipo T en la lista. Es constexpr y noexcept, y no lee ni copia el valor almacenado. La declaración exige que T aparezca exactamente una vez en Types....

En el ejemplo está activo std::string. Probar int da false y probar std::string da true, así que el formato bool ordinario imprime 0 1. Tras una prueba correcta, recupera el valor con std::get<T> u obtiene directamente un puntero con std::get_if<T>.

Un tipo repetido, como en std::variant<int, int>, no puede probarse con holds_alternative<int>: el programa está mal formado; distingue esas alternativas mediante index(). Un variant puede estar valueless_by_exception(), caso en que todas las pruebas son falsas. Prueba separada y mutación requieren sincronización normal si varios hilos comparten el objeto.

Ejemplos

#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

Fuentes