如何同步枚举故障名称与对应文本？求更优实现方案

针对你需要维护数百种故障枚举和对应文本的场景，以下是几种可以将枚举与文本定义整合的方案，避免重复维护两个独立列表：

方案一：预处理器宏整合定义（兼容旧C++标准） #

通过预处理器宏将枚举项和对应文本绑定，只需要维护一个定义文件，彻底避免枚举与文本不匹配的问题。

实现步骤： #

1. 创建一个包含所有故障定义的头文件（比如FaultDefinitions.inc），格式统一：

FAULT_DEF(OK, "Text describing OK")
FAULT_DEF(BAD, "Text describing Bad")
FAULT_DEF(WORSE, "Text describing Worse")
FAULT_DEF(FUBAR, "Text describing Fubar")
FAULT_DEF(OBLITERATED, "Text describing Obliterated")

2. 在主代码中通过宏分别生成枚举和文本数组：

// 定义两个宏，分别用于生成枚举项和文本内容
#define FAULT_DEF(name, desc) name,
#define FAULT_TEXT(name, desc) desc,

enum FaultNumber
{
#include "FaultDefinitions.inc"
    FAULT_COUNT // 自动统计故障总数，无需手动维护数组大小
};

class FAULT
{
public:
    const char* GetString(FaultNumber fault) const
    {
        static const char* cList[] =
        {
#include "FaultDefinitions.inc"
        };
        // 新增越界检查，避免非法索引
        if (fault >= 0 && fault < FAULT_COUNT)
            return cList[fault];
        return "Unknown Fault";
    }
};

int main()
{
    FAULT fault;
    const char* pText = fault.GetString(OK);
    // ... 其他调用
    return 0;
}

优势：只需要维护FaultDefinitions.inc一个文件，新增/修改故障仅需修改这一处；自动统计故障数量，不会出现数组大小与枚举数量不匹配的问题；兼容所有C++标准。

方案二：C++11+ 强枚举 + constexpr 结构体数组（类型安全） #

利用C++11的强类型枚举和constexpr特性，在编译期完成枚举与文本的绑定，类型更安全且性能优异。

#include <array>
#include <string_view>

// 强类型枚举，避免与int的隐式转换，提升类型安全性
enum class FaultNumber
{
    OK,
    BAD,
    WORSE,
    FUBAR,
    OBLITERATED,
    COUNT // 用于确定数组的编译期大小
};

// 绑定枚举ID与描述文本的结构体
struct FaultInfo
{
    FaultNumber id;
    std::string_view desc;
};

// 编译期初始化的故障列表，所有定义集中在一处
constexpr std::array<FaultInfo, static_cast<size_t>(FaultNumber::COUNT)> faultList = 
{
    {
        {FaultNumber::OK, "Text describing OK"},
        {FaultNumber::BAD, "Text describing Bad"},
        {FaultNumber::WORSE, "Text describing Worse"},
        {FaultNumber::FUBAR, "Text describing Fubar"},
        {FaultNumber::OBLITERATED, "Text describing Obliterated"}
    }
};

// 编译期可优化的文本查询函数
constexpr std::string_view GetFaultText(FaultNumber fault)
{
    for (const auto& info : faultList)
    {
        if (info.id == fault)
            return info.desc;
    }
    return "Unknown Fault";
}

int main()
{
    auto textOK = GetFaultText(FaultNumber::OK);
    auto textBAD = GetFaultText(FaultNumber::BAD);
    // ... 其他调用
    return 0;
}

优势：强枚举避免了非法的隐式转换；constexpr数组在编译期完成初始化，运行时无额外开销；所有故障定义集中在faultList和枚举中，维护时同步修改即可；std::string_view比const char*更灵活且无性能损耗。

方案选择建议 #

• 如果项目需要兼容C++11之前的旧标准，优先选择方案一；
• 如果项目使用C11及以上标准，优先选择方案二，其类型安全性和现代C特性的适配性更好。

内容的提问来源于stack exchange，提问作者Tom