C++ 结合 enum 按位与或组合检测枚举项

from deepseek.

---

在C++中，使用 &（按位与） 和 |（按位或） 来组合和检测枚举项，是处理标志位（flag）的标准做法。

这种用法通常是为枚举的每个成员赋予一个不同的二进制位（即1、2、4、8...），然后通过按位或（|）来组合它们，通过按位与（&）来检测某个位是否被设置。

---

1. 定义可组合的枚举

通常称为“位掩码”（Bitmask）枚举。关键是每个枚举值必须是2的幂，这样才能保证它们组合时不会互相重叠。

#include <iostream>

// 方法一：C++11 之前的标准做法
enum TextFormat {
    BOLD       = 1 << 0,  // 1
    ITALIC     = 1 << 1,  // 2
    UNDERLINE  = 1 << 2,  // 4
    STRIKETH   = 1 << 3   // 8
};

// 方法二：C++11 推荐的 `enum class`（强类型）
// 需要为它重载 | 和 & 运算符才能在逻辑判断中使用
enum class FileMode : int {
    READ   = 1 << 0,
    WRITE  = 1 << 1,
    APPEND = 1 << 2,
    BINARY = 1 << 3
};

// 为了 enum class 方便使用，重载位运算符
inline FileMode operator|(FileMode a, FileMode b) {
    return static_cast<FileMode>(static_cast<int>(a) | static_cast<int>(b));
}

inline bool operator&(FileMode a, FileMode b) {
    return (static_cast<int>(a) & static_cast<int>(b)) != 0;
}

---

2. 组合标志（使用 | 按位或）

你可以将多个标志组合成一个值，代表多种属性的集合。

int main() {
    // ---- 使用传统 enum ----
    int style = BOLD | UNDERLINE | ITALIC;
    // style 的二进制: 1 | 4 | 2 = 7

    // 判断是否包含某个标志（使用 & 按位与）
    if (style & BOLD) {
        std::cout << "文本是加粗的" << std::endl;
    }
    if (style & STRIKETH) {
        std::cout << "文本有删除线" << std::endl;  // 不会执行
    }

    // ---- 使用 enum class ----
    FileMode mode = FileMode::READ | FileMode::WRITE | FileMode::APPEND;
    if (mode & FileMode::WRITE) {
        std::cout << "文件可以写入" << std::endl;
    }

    return 0;
}

---

3. 常用操作模式

操作	代码示例	说明
设置标志	flags = READ | WRITE;	初始化时用 | 组合
添加标志	flags = flags | APPEND; 或 flags |= APPEND;	在不影响已有标志的情况下增加新标志
移除标志	flags = flags & ~APPEND; 或 flags &= ~APPEND;	~ 是取反运算符，将APPEND位变为0
检查标志	if (flags & APPEND)	只要包含该标志，结果为非零（true）
切换标志	flags = flags ^ APPEND; 或 flags ^= APPEND;	^ 是异或，有则移除，无则添加
精确判断	if ((flags & (READ | WRITE)) == (READ | WRITE))	判断是否同时包含多个标志

---

4. 完整的使用示例（函数参数）

这是最经典的场景：用一个整数参数接收多种配置选项。

#include <iostream>
#include <string>

enum LogOption {
    LOG_NONE    = 0,
    LOG_ERROR   = 1 << 0,  // 1
    LOG_WARNING = 1 << 1,  // 2
    LOG_INFO    = 1 << 2,  // 4
    LOG_DEBUG   = 1 << 3   // 8
};

void logMessage(const std::string& msg, int options) {
    if (options & LOG_ERROR)   std::cout << "[ERROR] ";
    if (options & LOG_WARNING) std::cout << "[WARNING] ";
    if (options & LOG_INFO)    std::cout << "[INFO] ";
    if (options & LOG_DEBUG)   std::cout << "[DEBUG] ";
    std::cout << msg << std::endl;
}

int main() {
    // 只输出错误和警告
    logMessage("Connection failed", LOG_ERROR | LOG_WARNING);
    
    // 输出所有信息
    logMessage("System started", LOG_ERROR | LOG_WARNING | LOG_INFO | LOG_DEBUG);
    
    return 0;
}

---

⚠️ 关键注意事项

注意事项	说明
枚举值必须是 2 的幂	这样每个标志对应独立的位，组合时才不会相互干扰
结果是非零表示 true	if (flags & FLAG) 是标准写法，不要写成 if ((flags & FLAG) == FLAG)，后者只在检查单个标志时等价，但前者更高效
enum class 需要运算符重载	传统 enum 会自动提升为 int，可以直接做位运算；enum class 需要手动重载
负数位运算可能有问题	确保枚举值是正数，不要让最高位变成符号位

---

💡 总结

符号	用途	典型场景
|	组合多个标志	flags = READ | WRITE;
&	检查是否包含某个标志	if (flags & WRITE)
|=	添加标志	flags |= APPEND;
&=	移除标志	flags &= ~APPEND;
^=	切换标志	flags ^= APPEND;

这种位掩码模式在 Windows API（如 MessageBox 的按钮组合）、Qt 的 setWindowFlags() 等大量库中被广泛使用，是 C/C++ 中处理多选项的标准模式。