1.合理的使用注释
注释为:/*…………*/
注释有以下几种情况:
1) 版本、版权声明。
2) 函数接口说明。
3) 重要的代码或者段落显示。
注释注意:
1) 注释是对代码的解释,不是对文档。注释不可喧宾夺主,注释不宜太多,花样也要少。
2) 如果代码本身很清楚,就不比加注释。
3) 边写代码边注释,在修改代码的同时修改注释,保证注释的一致性。
4) 没用的注释要及时删除。
5) 注释应该准确、易懂,防止出现二义性。
6) 尽量避免在注释中使用不常用的缩写。
7) 注释的位置要与所描述的代码相邻,可以放在代码的上面或右侧,不要将其放在下面。
2.程序中的{}要对其
程序中分解符“{”和“}”应占据一行并且位于同一列,同时与引用它们的语句左对齐,如下面的代码
void function(int n) { }
3.空格在程序中使用
1) 关键字后要留一个空格,如const、case等,否则编译器无法辨别它是否是关键字。if for while 等关键字后也应该留一个空格,然后在更小括号“(”,以突显关键字。
2) 在函数名之后不要留空格,要紧跟“(”,以示与关键字的区别
3) "("后向紧跟,“)”、“,”、“;”前向紧跟,紧跟出不留空格
4) “,”之后要留空格,如果“;”不是一行结束的,则最后要留空格。
5) 赋值操作符、比较操作符、算数操作符、逻辑操作符、位操作符前后都应该适当加空格。对于比较长的表达式,即使用了这些二员操作符,也应该适当去掉一些空格,是表达式更紧凑
6) 一元操作符如“!”、“~”、“++”、“--”等前后不加空格,如“[]”、“.”、“->”等操作符同样。
4.换行使代码更清晰
代码行最大的长度应该控制在70~80个字符内,代码行不要过长,否则用户不能一屏看完全,而且也不利于打印,长的表达式要在优先级操作符处拆分成新行,操作符放在新行的前面,用于突显操作符。拆分出来的新行要适当的缩进,使代码版式整齐,可读性增加,
1) 按操作符优先级拆分
if ((var1 > var2) &&(var3 < var4) &&(var5 < var6)) { dosomething(); }
2) 按表达式的意义拆分
for (initialization; condition; update) { dosomething(); }
5.正确使用标识符
标识符是指常量、变量、语句标号以及用户自定义函数的名称。使用标识符要遵循以下规则
1) 所有标识符必须由字母或下划线开头
2) 标识符的其他部分可以由字母、下划线或数字组成
3) 大小写字母表示不同的意义,即代表不同的标识符
4) 标识符不能使关键字