CKTIS / C++
std::to_underlying — convertir une énumération en son type sous-jacent
std::to_underlying, déclarée dans <utility>, convertit une valeur d’énumération vers son type sous-jacent exact. Disponible depuis C++23, elle est constexpr et noexcept ; elle n’impose pas le type int et ne vérifie pas que la valeur correspond à un énumérateur nommé.
Version : C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <utility>
template<class T>
constexpr std::underlying_type_t<T> std::to_underlying(T value) noexcept;std::to_underlying(value), déclarée dans <utility>, renvoie la représentation numérique d’une valeur d’énumération. Son type de retour est std::underlying_type_t<T>, où T est le type de l’argument. Elle fonctionne avec enum comme avec enum class ; ce n’est pas une fonction générale permettant de convertir n’importe quel argument en entier.
Le résultat est défini comme static_cast<std::underlying_type_t<T>>(value). Contrairement à static_cast<int>(value), la fonction conserve le type sous-jacent exact, y compris son caractère signé ou non, au lieu d’imposer int. C’est utile pour transmettre la représentation numérique d’une énumération à une autre interface.
La fonction est constexpr et peut donc participer à une évaluation constante. Elle est aussi noexcept et ne lève pas d’exception. Elle ne vérifie pas si la valeur fournie correspond à un énumérateur nommé. Elle n’effectue pas non plus la conversion inverse, d’un nombre vers une énumération.
Dans l’exemple, Status a pour type sous-jacent explicite unsigned int. Les assertions vérifient le type de retour, la valeur 7u et la propriété noexcept, tandis que le programme affiche 7. Le compilateur et la bibliothèque standard doivent tous deux prendre en charge C++23 ; un simple indicateur de compilation dans un dépôt ne garantit pas le fonctionnement dans un environnement d’exécution de production.
Exemples
#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';
}
Résultat
7
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.