讲师中心 微信公众号

工具推荐

视频效率加速
剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

c++如何使用std-underlying-type_c++枚举底层类型获取【核心】

轻枫同学_8880

轻枫同学_8880

发布时间:2026-03-16 16:26:03

|

604人浏览过

|

来源于php中文网

原创

std::underlying_type 是一个C++11起引入的类型别名模板,用于获取枚举类型的底层整数类型,必须配合::type或C++14起的::type_t使用,不能直接调用。

c++如何使用std-underlying-type_c++枚举底层类型获取【核心】

std::underlying_type 是什么,为什么不能直接用

它不是函数,也不是宏,而是一个类型别名模板——所以你不能像调用函数那样写 std::underlying_type(MyEnum)。常见错误是把它当函数用,结果编译报错:error: type/value mismatch at argument 1。必须配合 ::type 或 C++14 起的 ::type_t 才能拿到真实类型。

它的作用只有一个:从枚举类型反推它背后实际存储用的整数类型(比如 int、unsigned char),这对序列化、位操作、跨平台内存布局控制很关键。

  • 必须传入一个**已定义的枚举类型名**,不能是枚举值或未声明的 enum
  • 对 enum class 和传统 enum 都有效,但传统 enum 的底层类型可能由编译器推导,不显式指定时不可靠
  • C++11 起可用,头文件是 <type_traits></type_traits>

怎么正确获取并使用底层类型

最常用写法是搭配 typename 和 ::type,尤其在模板中需要声明变量或做类型判断时:

enum class Status : uint8_t { OK = 0, ERROR = 1 };
using underlying_t = typename std::underlying_type<Status>::type;
static_assert(std::is_same_v<underlying_t, uint8_t>); // ✅ 通过

如果只是临时转换一个枚举值,更简洁的是用 std::to_underlying(C++23 新增),但它和 std::underlying_type 不是一回事——后者是类型,前者是函数。

立即学习“C++免费学习笔记(深入)”;

C++14
C++14

C++14 对 C++11 的修正与增强版本,适合旧系统维护和较老工具链兼容。

下载
  • 旧代码(C++11/14/17)只能靠 static_cast<typename std::underlying_type>::type>(e)</typename>
  • C++20 可用 std::underlying_type_t<e></e> 简写,省去 typename ... ::type
  • 注意:如果枚举没显式指定底层类型(如 enum E { A };),std::underlying_type 仍合法,但具体类型由实现决定,可能是 int,也可能不是

容易踩的坑:隐式转换、无作用域枚举、负值处理

底层类型决定了枚举值能安全表示的范围。一旦你用 static_cast 强转成底层类型再做运算,就完全脱离枚举语义,可能溢出或符号翻转。

比如这个经典陷阱:

enum E : int8_t { MIN = -128, MAX = 127 };
auto x = static_cast<std::underlying_type_t<E>>(E::MIN) - 1; // x == -129,但 int8_t 存不下 → 实际是 127(回绕)
  • 对无作用域枚举(enum),若未指定底层类型,不同编译器可能选不同整型,std::underlying_type 返回的类型也不一致
  • 用 std::underlying_type 做 sizeof 判断时,要意识到它返回的是“声明时指定的类型”,不是“当前值实际占用的字节”(后者还受对齐影响)
  • 不要试图对底层类型做 reinterpret_cast 到枚举指针——未定义行为,尤其当底层类型比枚举实际值范围大时

什么时候其实不该用 std::underlying_type

如果你只是想把枚举值转成整数打印或比较,直接 static_cast<int>(e)</int> 更直白;如果你在写泛型代码且需要适配任意枚举,才真正需要它。

另一个现实约束:很多嵌入式或旧项目卡在 C++11,没有 std::underlying_type_t,也没有 std::to_underlying,这时必须手写 trait 或用宏兜底。

  • 过度依赖它会让代码显得“为泛型而泛型”,反而增加理解成本
  • 调试时看到 typename std::underlying_type<...>::type</...> 这一长串,远不如直接写 uint16_t 清晰(如果类型固定)
  • 它无法告诉你枚举是否“真的只用了底层类型的低 N 位”,这类信息得靠静态断言或文档约定

底层类型不是魔法,它只反映声明意图;运行时值是否越界、是否符合协议,还得靠你自己检查。

相关文章

c++速学教程(入门到精通)
c++速学教程(入门到精通)

c++怎么学习?c++怎么入门?c++在哪学?c++怎么学才快?不用担心,这里为大家提供了c++速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

c++

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

讯飞智作

讯飞智作是一款AI视频创作工具,AI文本配音工具,数字人课程、营销视频制作。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

相关专题

更多
scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1069

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3520

2023.10.25

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

7519

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

3565

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

4708

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

3145

2025.08.29

C++ 智能指针与现代内存管理
C++ 智能指针与现代内存管理

深入讲解 C++ 现代内存管理的核心工具——智能指针,涵盖 unique_ptr 独占所有权语义、shared_ptr 引用计数机制与循环引用问题、weak_ptr 弱引用的应用场景、make_unique/make_shared 工厂函数的性能优势、自定义删除器的编写、RAII 资源管理思想的实践,以及从裸指针迁移到智能指针的重构策略,帮助开发者编写安全无泄漏的现代 C++ 代码。

399

2026.04.23

class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

4616

2024.01.03

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

20

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn