C/C++ - 命名规范

1. 避免名字中出现数字编号，这是为了防止程序员偷懒，不肯为命名动脑筋而导致产生无意义的名字（因为用数字编号最省事）。

2. 除了异常类等个别情况（不希望用户把该类看作一个普通的、正常的类之情况）外，C++类/结构的命名应该遵循以下准则：

   • C++类/结构的命名：类的名称都要以大写字母“C”开头，后跟一个或多个单词。为便于界定，每个单词的首字母要大写。
   • 推荐的组成形式：类的命名推荐用"名词"或"形容词＋名词"的形式，例如：“CAnalyzer”, “CFastVector” 等

3. 函数

   • 函数的名称由一个或多个单词组成。为便于界定，每个单词的首字母要大写。
   • 推荐的组成形式：函数名应当使用"动词"或者"动词＋名词"（动宾词组）的形式。例如：“GetName()”, “SetValue()”, “Erase()”, “Reserve()”
   • 保护成员函数的开头应当加上一个下划线“_”以示区别，例如："_SetState()" …
   • 私有成员函数的开头应当加上两个下划线“__”，例如："__DestroyImp()" …
   • 虚函数习惯以“Do”开头，如：“DoRefresh()”, “_DoEncryption()” …
   • 回调和事件处理函数习惯以单词“On”开头。例如："_OnTimer()", “OnExit()” …

4. 变量应该是程序中使用最多的标识符了，变量的命名规范可能是一套C++命名准则中最重要的部分：

   变量名由作用域前缀＋类型前缀＋一个或多个单词组成。为便于界定，每个单词的首字母要大写。

   • 对于某些用途简单明了的局部变量，也可以使用简化的方式，如：i, j, k, x, y, z
   • 作用域前缀标明一个变量的可见范围。作用域可以有如下几种：
     • 局部变量无前缀
     • 类的成员变量（member）前缀m_
     • 类的静态成员变量（static member）前缀sm_
     • 静态变量（static）前缀s_
     • 外部全局变量（global）前缀g_
     • 静态全局变量（static global）sg_
     • 进程间共享的共享数据段全局变量（global global）gg_（除非不得已，否则应尽可能少使用全局变量）
   • 类型前缀标明一个变量的类型，可以有如下几种：
     • 整型和位域变量（number）n
     • 枚举型变量（enumeration）e
     • 字符型变量（char）c
     • 布尔型变量（bool）b
     • 浮点型变量（float）f
     • 指针型变量和迭代子（pointer）p
     • 特别针对指向函数的指针变量和函数对象指针（pointer of function）pfn
     • 数组（grid）g
     • 类的实例（instance）i
     • 对于经常用到的类，也可以定义一些专门的前缀，如：std::string和std::wstring类的前缀可以定义为"st"，std::vector类的前缀可以定义为"v"等等。
     • 类型前缀可以组合使用，例如"gc"表示字符数组，"ppn"表示指向整型的指针的指针等等。

5. 常量名由类型前缀＋全大写字母组成，单词间通过下划线来界定，如：cDELIMITER, nMAX_BUFFER …
   类型前缀的定义与变量命名规则中的相同。

6. 枚举、联合、typedef语句生成的类型名由全大写字母组成，单词间通过下划线来界定，如：FAR_PROC, ERROR_TYPE …

7. 宏和枚举值由全大写字母组成，单词间通过下划线来界定，如：ERROR_UNKNOWN, OP_STOP