C++编码规范与命名规则详解

"C++编程规范.doc" C++编程规范是一个重要的文档，旨在确保代码的一致性、可读性和可维护性。这份规范是上海SMISOL公司于2001年4月16日发布的Version1.1版本，强调了在C++编程中应遵循的规则，特别关注代码的物理结构和外观，而非逻辑结构。以下是规范中的关键要点： 1. **命名规则**：这是规范的核心部分，它规定了如何为各种编程元素（如变量、函数、类和工程）选择清晰、易读的名称。命名要使用英语，单词简洁，意义明确。每个单词首字母大写，单词间通过大写字母区分，且定语应放在被修饰语前面。例如，变量名`myVariableName`，而不是`variableNameMy`。 2. **匈牙利命名法**：复杂变量（如类、结构的实例）应遵循匈牙利命名法，即在变量名前加上表示其类型的缩写。同时，为了提供足够的信息，名称长度应适中，既不过短导致含义模糊，也不过长影响可读性。例如，一个整型变量可以命名为`iMyInteger`。 3. **工程命名**：工程项目的名称应反映其实际意义，并在前面添加大写的"SS"（代表ShangHaiSmisol），如`SSModel`。对应的Visual C++工程文件名将是`SSModel.dsp`。 4. **类命名**：所有类的名称必须以"CSS"开头，首字母大写，如`CSSImage`。类的头文件和源文件名遵循VC的命名规则，即去掉"C"，如`SSImage.h`和`SSImage.cpp`。 5. **函数命名**： - **全局函数**：应采用"限定名词+动词[+名词]"的模式，如`RmodelGetCenter`，其中`Rmodel`是限定名词，`Get`是动词，`Center`是名词。 - **类成员函数**：使用"动词[+名词]"的方式，如`GetWidth`，其中`Get`是动词，`Width`是名词。在类`CRImage`中，`GetWidth`函数获取图像的宽度，类的成员函数通常不包含表示对象本身的名词，因为它已经隐含在所属的类名中。 这些规范不仅适用于上海SMISOL公司的项目，也对任何希望提升C++代码质量的开发团队有参考价值。遵循这样的规范，可以使代码更容易理解，减少出错的可能性，并提高团队间的协作效率。通过使用一致的命名约定，代码的可读性和可维护性将显著增强，从而降低长期的维护成本。因此，无论是新手还是经验丰富的开发者，都应该重视并遵守编程规范。