软件编程规范之注释

<1:一般情况下,源程序有效注释量必须在20%以上。 说明:注释的原则是有助于对程序的阅读理解,在该加的地方都加了,注释不宜太多也不能太少,注释语言必须准确、易懂、简洁。 <2:说明性文件(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应进行注释,注释必须列出 … 阅读更多

软件编程规范之排版

<1:程序块要采用缩进风格编写,缩进的空格数为4个。 说明: 对于由开发工具自动生成的代码可以有不一致。 <2:相对独立的程序块之间、变量说明之后必须加空行。 示例: 如下例子不符合规范。 if (!valid_ni(ni)) { … // program code } repssn_i … 阅读更多