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.