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

CKTIS / C++

std::to_underlying: convertir una enumeración a su tipo subyacente

std::to_underlying, declarada en <utility>, convierte un valor de enumeración a su tipo subyacente exacto. Disponible desde C++23, es constexpr y noexcept; no fuerza el tipo int ni comprueba que el valor corresponda a un enumerador con nombre.

Versión: C++23; repository compiler flag, production runtime not attested

Sintaxis

#include <utility>

template<class T>
constexpr std::underlying_type_t<T> std::to_underlying(T value) noexcept;

std::to_underlying(value), declarada en <utility>, devuelve la representación numérica de un valor de enumeración. Su tipo de retorno es std::underlying_type_t<T>, donde T es el tipo del argumento. Funciona tanto con enum como con enum class; no es una función de propósito general para convertir argumentos arbitrarios en enteros.

El resultado se define como static_cast<std::underlying_type_t<T>>(value). A diferencia de static_cast<int>(value), la función conserva el tipo subyacente exacto, incluido si es con signo o sin signo, en lugar de forzar int. Esto resulta útil al pasar la representación numérica de una enumeración a otra interfaz.

La función es constexpr, por lo que puede participar en la evaluación de constantes, y noexcept, por lo que no lanza excepciones. No comprueba si el valor proporcionado corresponde a un enumerador con nombre. Tampoco realiza la conversión inversa, de un número a una enumeración.

En el ejemplo, Status tiene el tipo subyacente explícito unsigned int. Las aserciones comprueban el tipo de retorno, el valor 7u y la propiedad noexcept, mientras que el programa imprime 7. Se requiere compatibilidad con C++23 tanto en el compilador como en la biblioteca estándar; una opción del compilador en un repositorio por sí sola no acredita que funcione en un entorno de ejecución de producción.

Ejemplos

#include <iostream>
#include <type_traits>
#include <utility>

enum class Status : unsigned int {
    ready = 7,
    done = 9
};

static_assert(std::is_same_v<
    decltype(std::to_underlying(Status::ready)), unsigned int>);
static_assert(std::to_underlying(Status::ready) == 7u);
static_assert(noexcept(std::to_underlying(Status::ready)));

int main() {
    std::cout << std::to_underlying(Status::ready) << '\n';
}

Resultado

7

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes