高质量C++/C编程指南-第3章-命名法则(1)[VC/C++编程]

第3章 命名法则
对比闻名的命名法则当推Microsoft公司的“匈牙利”法,该命名法则的主要思惟是“在变量和函数名中加入前缀以增长人们对程序的理解”.比方全部的字符变量均以ch为前缀,若是指针变量则追加前缀p.假如一个变量由ppch开首,则表明它是指向字符指针的指针. “匈牙利”法最大的缺陷是烦琐,比方

int i, j, k;

float x, y, z;

假使采取“匈牙利”命名法则,则该当写成

int iI, iJ, ik; // 前缀 i表示int范例

float fX, fY, fZ; // 前缀 f表示float范例

如此烦琐的程序会让绝大大都程序员无法忍耐.

据观察,没有一种命名法则可以让全部的程序员赞成,程序计划教科书普通都不指定命名法则.命名法则对软件产品而言并非“成败悠关”的事,我们不要化太多精神试图创造世界上最好的命名法则,而该当拟定一种令大大都项目成员称心的命名法则,并在项目中贯彻实施.

3.1 共性法则
本节阐述的共性法则是被大大都程序员采取的,我们该当在遵守这些共性法则的前提下,再扩大特定的法则,如3.2节.

l 【法则3-1-1】标识符该当直观且可以拼读,可望文知意,没必要举行“解码”.

标识符最好采取英文单词或其组合,便于记忆和阅读.切忌利用汉语拼音来命名.程序中的英文单词普通不会太复杂,用词该当精确.比方不要把CurrentValue写成NowValue.

l 【法则3-1-2】标识符的长度该当符合“min-length && max-information”原则.

几十年前老ANSI C规命名字不准超越6个字符,当今的C++/C不再有此限制.普通来说,长名字能更好地表达含义,所以函数名、变量名、类名长达十几个字符不足为怪.那么名字能否越长约好?不见得! 比方变量名maxval就比maxValueUntilOverflow好用.单字符的名字也是有效的,常见的如i,j,k,m,n,x,y,z等,它们普通可用作函数内的部分变量.

l 【法则3-1-3】命名法则尽大概与所采取的操作系统或开辟工具的气势保持一致.

比方Windows利用程序的标识符普通采取“大小写”混排的方法,如AddChild.而Unix利用程序的标识符普通采取“小写加下划线”的方法,如add_child.别把这两类气势混在一同用.

l 【法则3-1-4】程序中不要呈现仅靠大小写辨别的类似的标识符.

比方:

int x, X; // 变量x 与 X 简单混合

void foo(int x); // 函数foo 与FOO简单混合

void FOO(float x);

l 【法则3-1-5】程序中不要呈现标识符完好相同的部分变量和全局变量,固然二者的作用域差别而不会发生语法错误,但会令人曲解.

l 【法则3-1-6】变量的名字该当利用“名词”大概“描述词＋名词”.

比方:

float value;

float oldValue;

float newValue;

l 【法则3-1-7】全局函数的名字该当利用“动词”大概“动词＋名词”（动宾词组）.类的成员函数该当只利用“动词”,被省略掉的名词就是对象本身.

比方:

DrawBox(); // 全局函数

box->Draw(); // 类的成员函数