c++ - 有什么理由不为 C++ 中的大量私有(private)类常量声明从另一个文件中#include 吗？

Question

当类定义了大量私有(private)常量时，为什么不应该在类声明中#include 另一个文件？

我正在编写一个类，它遵循一个简单的状态转换系统，并定义了一个由多个状态组成的处理计划，每个状态都由一系列步骤组成。因为类在各种函数中都要引用这些状态和步骤(例如，根据当前状态和步骤确定应用哪个处理时)，所以我最终在类声明中定义了一堆私有(private)枚举来实现可读(因此我可以引用 kStates_ModeTransition 和 kStateSteps_ModeTransition_PrepareNewSetup 等内容，而不仅仅是使用与这些状态和步骤关联的原始整数值)。

随着状态和状态步骤的列表越来越长，这个枚举的集合已经成为类声明中间相当长、笨拙的代码块，我觉得这些常量与实现的联系比接口(interface)——类的用户不一定要知道它们。有什么理由不应该将所有这些枚举移动到另一个文件，然后只是将该文件#include 到类声明的私有(private)部分？我还没有遇到过在类的主体中使用#include 似乎是合适的另一种情况，所以我想知道是否有更好的方法来处理这个问题或任何特殊原因，例如#include 是错误的形式。此外，是否有任何合理的标准文件扩展名可用于此类文件，仅用于文本插入(它不是真正的标题......)？只是 .txt？

谢谢!

编辑:再看看上面提到的替代方案之一是否完全解决了我的困境:

试图只坚持要点，这是我当前结构的一个例子

// Processor.h

class Processor
{
public:

    Processor();
    void Process( float* input, float* output, int numSamples );

private:

    // List of possible states
    enum
    {
        kStates_Default,
        kStates_SettingChangeImmediate,
        kStates_SettingChangeCrossfade,
        kStates_SpecialProcessing,
        kStates_NumStates
    };

    // Lists of steps for each state...
    enum
    {
        kStateSteps_Default_PrepareInput,
        kStateSteps_Default_CalculateIntermediateValues,
        kStateSteps_Default_CalculateOutput,
        kStateSteps_Default_NumSteps
    };


    // Imagine more lists for other states here, with comments...

    // Becoming quite long...


    // Private functions used in implementing various processing steps 
    //      (some are used by multiple state-steps in varying ways)
    void PrivateFunction1();
    void PrivateFunction2();


    // Some member variables here
};

这用于实时处理上下文中，以便在执行 block 处理任务时更好地平衡 DSP 负载。实际上，此类继承自一个基类，该基类处理对 Process 调用的实际调度，根据需要更新当前状态和状态步骤。 Process() 然后由一个 switch 语句组成，该语句根据对象的当前状态和状态步骤执行某些处理功能和 IO。

在枚举中声明的值在 Process() 和 processor.cpp 中的其他私有(private)成员函数中使用，而不在其他地方使用。我已将它们声明为私有(private)成员变量，以将它们限定在类内。有没有办法在 .cpp 中声明它们并实现相同的范围？这些都是在编译时优化掉的常量整数，本质上被用作 #define 的 - 我只是不想使用宏。

Answer 1

所有包含只是文本包含。由于您包含的文件包含 C++ 语法，因此它应该具有 C++ header 扩展名(.h 或 .hpp 等)。

您可能不需要将它包含在声明中(如果您发布一些代码，我可以更肯定地说)......您可以将它包含在实现文件中，并将任何枚举成员变量声明为 int ... 如果您想为它们提供描述性类型名称，请使用 typedef(int 的别名)。或者，如果您使用的是 C++11，则可以在不定义枚举类型的情况下转发声明它们，然后枚举成员变量将是类型安全的，从而防止分配错误类型的枚举值。

至于你是否有理由不将枚举从你的类声明中移到另一个文件中并包含该文件的问题:人们总是可以发明不做某事的理由，例如“我们的编码标准说永远不要在顶层，在文件的顶部之外包含文件”，但是如果这样的任意原因不适用于您，那么不，没有理由。做对代码可维护性最有意义的事情。