C语言编程规范概要

编程规范概要

一、 程序结构清析，简单易懂，单个函数的程序行数不得超过100行。

二、 打算干什么，要简单，直截了当，代码精简，避免垃圾程序。

三、 尽可能使用标准库函数和公共函数。

四、 不要随意定义全局变量，尽可能使用局部变量。

五、 使用括号以免二义性。

 

可读性要求

一、可读性第一，效率第二。

二、保持注释与代码彻底一致。

三、每一个源程序文件，都有文件头说明，说明规格见规范。

四、每一个函数，都有函数头说明，说明规格见规范。

五、主要变量（结构、联合、类或对象）定义或引用时，注释能反映其含义。

六、常量定义（DEFINE）有相应说明。

七、处理过程的每一个阶段都有相关注释说明。

八、在典型算法前都有注释。

九、利用缩进来显示程序的逻辑结构，缩进量一致并以Tab键为单位(定义Tab为 6个字节)

十、循环、分支层次不要超过五层。

十一、注释能够与语句在同一行，也能够在上行。

十二、空行和空白字符也是一种特殊注释。

1三、一目了然的语句不加注释。

1四、注释的做用范围能够为：定义、引用、条件分支以及一段代码。

1五、注释行数(不包括程序头和函数头说明部份)应占总行数的1/5 到 1/3 。