C++如何使用std::to_underlying获取枚举的基础值-C++-PHP中文网

std::to_underlying是C++23新增的constexpr函数模板，用于将枚举值安全转为其显式指定的底层整数类型，仅接受枚举值（非类型名），等价于static_cast但更类型安全，不进行范围检查。

c++如何使用std::to_underlying获取枚举的基础值

std::to_underlying 是 C++23 新增的工具，不是所有编译器都支持

如果你在 g++ 或 clang++ 下编译时报错 “‘to_underlying’ is not a member of ‘std’”，大概率是因为标准库还没跟上 C++23。libstdc++（GCC 默认）直到 GCC 13 才开始部分支持 std::to_underlying，而 libc++（Clang 默认）在 LLVM 17+ 中才提供完整实现。MSVC 从 19.35（VS 2022 17.5）起支持，但需显式开启 /std:c++23。

确认编译器版本：运行 g++ --version 或 clang++ --version
启用 C++23 标准：加编译选项 -std=c++23（GCC/Clang）或 /std:c++23（MSVC）
头文件只需 #include ，无需额外引入枚举定义头

只能用于有固定底层类型的枚举（enum class 或带 : T 的 enum）

std::to_underlying 接受一个枚举值，返回其底层整型值；但它不接受传统无作用域枚举（plain enum），也不接受未指定底层类型的 enum class（某些老编译器会隐式推导，但标准要求显式声明）。

✅ 正确用法：enum class E : int { A = 1 }; auto x = std::to_underlying(E::A);
❌ 编译失败：enum E { A }; std::to_underlying(E::A);（缺少底层类型）
❌ 运行时未定义：enum class E { A }; std::to_underlying(E::A);（C++23 要求必须显式指定底层类型）
底层类型可以是 char、short、int、unsigned long long 等可提升整型，但不能是 bool 或浮点类型

和 static_cast 的行为一致，但更类型安全

它本质就是对枚举值做一次 static_cast 到其底层类型，但封装后避免了手动写错目标类型的错误。比如枚举底层是 long long，你误写成 static_cast(e) 可能截断；而 std::to_underlying(e) 自动匹配底层类型。

等价关系：std::to_underlying(e) ≡ static_cast<:underlying_type_t>>(e)
不改变值：不会做符号扩展或零扩展以外的转换，负值保持负，高位保留
不检查范围：如果枚举值超出底层类型表示范围（极少发生），行为仍是未定义，它不做校验
性能无开销：纯编译期转换，生成的汇编和 static_cast 完全一样

替代方案：C++20 及更早版本怎么安全取值

如果无法升级到 C++23，又想避免手写 static_cast 的隐患，可以自己写个轻量封装：

C++14

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

下载

template <typename e>
constexpr std::underlying_type_t<e> to_underlying(E e) noexcept {
    return static_cast<:underlying_type_t>>(e);
}
</:underlying_type_t></e></typename>

这个模板和标准版语义一致，但注意：std::underlying_type_t 对 plain enum 有效，而标准 std::to_underlying 不接受 plain enum —— 这是关键差异。若你项目里混用两种枚举，得自己判断是否允许 plain enum。

真正容易被忽略的是：即便用了 std::to_underlying，也不能绕过枚举的类型安全设计初衷。把它当“解包工具”用没问题，但别用它去干 reinterpret_cast 的事，比如把值塞进非对应枚举类型里再 cast 回来 —— 那已经超出枚举值合法范围，UB 就藏在那里。