Bootstrap

编程书法:高质量c/c++编程 (第三章)

3.命名规则

3.1共性规则

规则一:标识符应当直观且可以拼读,可望文知意,不必进行“解码”。

应当采用英文单词及其组合,切忌使用汉语拼音

eg:

正确标识符:currentvalue

错误标识符:dangqianzhi


规则二:标识符的长度应当符合“min-length && max-information”原则。

也就是用最短的字符量表示最多的信息

eg:maxValueUntilOverflow-》maxval


规则三:命名规则尽量与所采用的操作系统或开发工具的风格保持一致

例如 Windows 应用程序的标识符通常采用“大小写”混排的方式,如 AddChild

规则四:程序中不要出现仅靠大小写区分的相似的标识符

eg:int x 与int X


规则五:程序中不要出现标识符完全相同的局部变量和全局变量,尽管两者的

作用域不同而不会发生语法错误,但会使人误解。

规则六:变量的名字应当使用“名词”或者“形容词+名词”。

eg:int value;

       int oldvalue;


规则七:全局函数的名字应当使用“动词”或者“动词+名词”(动宾词组)。

类的成员函数应当只使用“动词”,被省略掉的名词就是对象本身。
eg:attack();
heroattack();
类中:attack();

规则八:尽量避免名字中出现数字编号,如 Value1,Value2 等,除非逻辑上的

确需要编号。
主要是为了避免出现无意义的名字

3.2 简单的 Windows 应用程序命名规则

规则一:类名和函数名用大写字母开头的单词组合而成。

eg:class Test

        void Print()


规则二:变量和参数用小写字母开头的单词组合而成。

eg:int sumNum

void Print(int apple)


规则三:常量全用大写的字母,用下划线分割单词。

eg:const int A 

const int SUM_NUM


规则四:静态变量加前缀 s_(表示 static)。

eg:static int s_staticVal


规则五:如果不得已需要全局变量,则使全局变量加前缀 g_(表示 global)。

eg:int g_globalVal


规则六:类的数据成员加前缀 m_(表示 member),这样可以避免数据成员与

成员函数的参数同名。
eg:int  m_value
;