std::has_single_bit 是 C++20 判断整数是否为 2 的幂的 constexpr 函数，仅对非负整型有效，适用于内存对齐、哈希表容量校验等场景，语义比 x & (x-1) == 0 更清晰且对 0 明确定义为 false。
std::has_single_bit 是什么，什么时候该用它
std::has_single_bit 是 C++20 引入的 constexpr 函数，用于判断一个整数是否是 2 的幂（即二进制表示中仅有一个 bit 为 1，其余全为 0）。它不处理负数、零或非整型类型，只对无符号整数或有符号整数的正值有效。
常见误用场景：有人拿它检查“是不是只有一个 bit 被置位”，却传入 0 或负值，结果行为未定义（实际编译器通常返回 false，但标准不保证）。
- 只接受整型（
int、unsigned long long等），不接受浮点或自定义类型 - 输入为
0时返回false（因为 0 的二进制没有 1） - 输入为负数时，行为取决于底层表示（通常按补码解释，比如
-4是...11111100，肯定不止一个 1），应避免
怎么写才不出错：参数类型和边界检查
std::has_single_bit 要求参数是整型，且最好显式转为无符号类型以规避符号扩展歧义。尤其在模板泛型代码里，容易因类型推导出 int 而传入负值。
- 永远先确认输入 >= 0，再调用；或者直接用无符号类型变量
- 不要依赖
std::has_single_bit(x)替代x > 0 && (x & (x - 1)) == 0的手动判断——前者更语义清晰，但后者兼容 C++11 - 在 constexpr 上下文中安全使用，比如作为
static_assert条件
constexpr unsigned int size = 1024; static_assert(std::has_single_bit(size), "size must be power of two");
和 x & (x-1) == 0 的区别在哪
两者逻辑等价（对 x > 0 的整数），但语义与约束不同：
立即学习“C++免费学习笔记（深入）”；
-
x & (x - 1) == 0是经典位运算技巧，适用于所有 C++ 版本，但需额外判断x != 0 -
std::has_single_bit(x)封装了这层逻辑，且对0明确定义为false，语义更直白 - 性能上无差异（现代编译器对二者都优化为单条指令，如 x86 的
blsi+ 测试） - 编译期常量表达式中，
std::has_single_bit更易读，也更难写错（比如漏掉x != 0判断）
实际用在哪：内存对齐、哈希表容量、位掩码验证
典型使用场景不是“随便检查一个数”，而是配合系统约束做静态/运行时校验：
- 分配器要求缓冲区大小为 2 的幂（如某些 SIMD 对齐策略）
- 哈希表扩容时验证新 bucket 数是否为 2 的幂（避免取模变慢）
- 验证用户传入的位掩码是否合法（比如只允许
1U,2U,4U…）
void set_mask(unsigned mask) {
if (!std::has_single_bit(mask)) {
throw std::invalid_argument("mask must have exactly one bit set");
}
this->mask_ = mask;
}
真正容易被忽略的是：它只告诉你“有没有单个 bit”，不告诉你“是哪个 bit”——需要额外用 std::countr_zero 或 __builtin_ctz 获取位置。如果业务同时需要位置和有效性，别只调一次 has_single_bit 就完事。
