《代码大全(第2版) ((美)迈克康奈尔(McConnell.S)著 金戈, 汤凌, 陈硕, 张菲译) (Z-Library)》
(美)迈克康奈尔(McConnell.S)著 金戈,汤凌,陈硕,张菲译
5个笔记
◆ 为常量命名
>> FIVE是个很糟的常量名(不论它所代表的值是否为5.0)。CYCLES_NEEDED是个不错的名字。CYCLES_NEEDED可以等于5.0或者6.0。而FIVE=6.0就显得太可笑了。
◆ 11.4 非正式命名规则
>> 区分变量名和子程序名字本书所采用的命名规则要求变量名和对象名以小写字母开始,子程序名字以大写字母开始:variableName对RoutineName()。区分类和对象类名字与对象名字一或者类型与该类型的变量一一之间的关系会比较棘手。有很多标准的方案可用,如下例所示:方案1:通过大写字母开头区分类型和变量Widget widget;LongerWidget longerWidget;方案2:通过全部大写区分类型和变量WIDGET widget,LONGERWIDGET longerWidget方案3:通过给类型加“t_”前缀区分类型和变量t_Widget Widget;
>> 方案4:通过给变量加“a”前缀区分类型和变量Widget aWidget;LongerWidget aLongerWidget;方案5:通过对变量采用更明确的名字区分类型和变量Widget employeeWidget¡
>> 如果你看到constMax.SetNewMax(…),就会知道这里有大漏洞,因为const前缀表明了该变量是不应该被修改的。
◆ 11.6 创建具备可读性的短名称
>> 使用标准的缩写(列在字典中的那些常见缩写)。去掉所有非前置元音。(computer变成cmptr,screen变成scrn, apple变成appl,integer变成intgr。)去掉虚词and, or, the等。使用每个单词的第一个或前几个字母。统一地在每个单词的第一、第二或者第三个(选择最合适的一个)字母后截断。保留每个单词的第一个和最后一个字母。使用名字中的每一个重要单词,最多不超过三个。去除无用的后缀一ing,ed等。保留每个音节中最引人注意的发音。确保不要改变变量的含义。反复使用上述技术,直到你把每个变量名的长度缩减到了8到20个字符,或者达到你所用的编程语言对变量名的限制字符数。