2014编程规和例.docVIP

4 可读性 4-1：注意运算符的优先级，并用括号明确表达式的操作顺序，避免使用默认优先级。 说明：防止阅读程序时产生误解，防止因默认的优先级与设计思想不符而导致程序出错。 示例：下列语句中的表达式 word = (high 8) | low (1) if ((a | b) (a c)) (2) if ((a | b) (c d)) (3) 如果书写为 high 8 | low a | b a c a | b c d 由于 high 8 | low = ( high 8) | low, a | b a c = (a | b) (a c)， (1)(2)不会出错，但语句不易理解； a | b c d = a | （b c） d，(3)造成了判断条件出错。 4-2：避免使用不易理解的数字，用有意义的标识来替代。涉及物理状态或者含有物理意义的常量，不应直接使用数字，必须用有意义的枚举或宏来代替。 示例：如下的程序可读性差。 if (Trunk[index].trunk_state == 0) { Trunk[index].trunk_state = 1; ... // program code } 应改为如下形式。 #define TRUNK_IDLE 0 #define TRUNK_BUSY 1 if (Trunk[index].trunk_state == TRUNK_IDLE) { Trunk[index].trunk_state = TRUNK_BUSY; ... // program code } 4-1：源程序中关系较为紧密的代码应尽可能相邻。 说明：便于程序阅读和查找。 示例：以下代码布局不太合理。 rect.length = 10; char_poi = str; rect.width = 5; 若按如下形式书写，可能更清晰一些。 rect.length = 10; rect.width = 5; // 矩形的长与宽关系较密切，放在一起。 char_poi = str; 4-2：不要使用难懂的技巧性很高的语句，除非很有必要时。 说明：高技巧语句不等于高效率的程序，实际上程序的效率关键在于算法。 示例：如下表达式，考虑不周就可能出问题，也较难理解。 * stat_poi ++ += 1; * ++ stat_poi += 1; 应分别改为如下。 *stat_poi += 1; stat_poi++; // 此二语句功能相当于“ * stat_poi ++ += 1; ” ++ stat_poi; *stat_poi += 1; // 此二语句功能相当于“ * ++ stat_poi += 1; ” 1．空行 在每个类声明之后、每个函数定义结束之后都要加空行。 示例 // 空行 void Function1(…) { … } // 空行 void Function2(…) { … } // 空行 void Function3(…) { … } 在一个函数体内，逻揖上密切相关的语句之间不加空行，其它地方应加空行分隔。 示例 // 空行 while (condition) { statement1; // 空行 if (condition) { statement2; } else { statement3; } // 空行 statement4; } 2．代码行 一行代码只做一件事情，如只定义一个变量，或只写一条语句。这样的代码容易阅读，并且方便于写注释。 示例：如下定义。 int width, height, depth; // 宽度高度深度 应改为如下。 int width; // 宽度 int height; // 高度 int depth; // 深度 if、for、while、do等语句自占一行，执行语句不得紧跟其后。不论执行语句有多少都要加{}。这样可以防止书写失误。 示例：如下代码。 if (width height) dosomething(); 应改为如下。 if (width height) { dosomething(); } 尽可能在定义变量的同时初始化该变量（就近原则） 如果变量的引用处和其定义处相隔比较远，变量的初始化很容易被忘记。如果引用了未被初始化的变量，可能会导致程序错误。本建议可以减少隐患。例如 int width = 10; // 定义并初绐化width int height = 10; // 定义并初绐化height int depth =