C语言编程规范总则

《C语言编程规范总则》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

1、编程规范总则编程规范总则11排版12注释33标识符命名74可读性95变量、结构106函数、过程147程序效率198质量保证239代码编辑、编译、审查2810代码测试、维护2911宏301排版1-1:程序块要采用缩进风格编写，缩进的空格数为4个。说明：对于由开发工具自动生成的代码可以有不一致。1-2:相对独立的程序块之间、变量说明之后必须加空行。示例：如下例子不符合规范。if(!valid_ni(ni)){…〃programcode}repssn_ind=ssn_data[index].repssn_index;repssn_n

2、i=ssn_data[index].ni;应如下书写讦(!valid_ni(ni)){...//programcode}repssn=ssn_data[index],repssndex;repssn_ni=ssn_data[index].ni;1-3:较长的语句(>80字符)要分成多行书写，长表达式要在低优先级操作符处划分新行,操作符放在新行之首，划分出的新行要进行适当的缩进，使排版整齐，语句可读。示例：permcountmsg.head.len=NO7TOSTATPERMCOUNTLEN+STAT_SIZE_PER_FRAM

3、*sizeof(_UL);act_task_table[frame_id*STAT_TASK_CHECK_NUMBER+index],occupied=stat_poi[index].occupied;act_task_table[taskno].duration_true_or_false=SYS_get_sccp_statistic_state(stat_item);report_or_not_flag=((taskno

4、item))&&(act_task_table"askno].result_data!=()));1-4:不允许把多个短语句写在一行中，即一行只写一条语句。示例：如下例子不符合规范。rect.length=0;rect.width=0;应如下书写rect.length=0;rect.width=0;1-5:讦.fbrNdoxwhile,case,switch,default等语句自占一行,且if.for.do^while等语句的执行语句部分无论多少都要加括号｛｝。示例：如下例子不符合规范。if(pUserCR==NULL)re

5、turn;应如下书写：讦(pUserCR==NULL)｛return;1-6:对齐只使用空格键，不使用TAB键。说明：以免用不同的编辑器阅读程序时，因TAB键所设置的空格数目不同而造成程序布局不整齐，不要使用BC作为编辑器合版本，因为BC会自动将8个空格变为一个TAB键，因此使用BC合入的版本大多会将缩进变乱。1-7:函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格,case语句下的情况处理语句也要遵从语句缩进要求。：程序块的分界符(如C/C++语言的大括号｛'和｝')应各独占一行并且位于同一列，同时与引

6、用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、foido、while、switch、case语句中的程序都要采用如上的缩进方式。示例：如下例子不符合规范。for(...)｛...//programcodeif(…){...//programcodevoidexample_fun(void){...//programcode应如下书写。for(...){...//programcode}if(…){...//programcode}voidexample_fun(void){...//progr

7、amcode}1-9:一行程序以小于80字符为宜,不要写得过长。2注释1-1:一般情况下，源程序有效注释量必须在20%以上。说明：注释的原则是有助于对程序的阅读理解，在该加的地方都加了，注释不宜太多也不能太少，注释语言必须准确、易懂、简洁。1-2:文件头部应进行注释，注释必须列出：版权说明、版本号、生成日期、作者、内容、功能、修改日志等。示例：下面这段头文件的头注释比较标准，当然，并不局限于此格式，但上述信息建议要包含在内。Copyright:1988-1999,HuaweiTech.Co.,Ltd.Filename:Desc

8、ription:文件名用于详细说明此程序文件完成的主要功能，与其他模块或函数的接口，输出值、取值范围、含义及参数间的控制、顺序、独立或依赖等关系Author:Version:Date:作者版本完成日History:修改历史记录列表，每条修改记录应包括修改日期、修改者及修改内容