欢迎来到天天文库
浏览记录
ID:28462098
大小:261.84 KB
页数:35页
时间:2018-12-10
《软件编码规范和范例》由会员上传分享,免费在线阅读,更多相关内容在学术论文-天天文库。
1、软件编码规范和范例123456排版注释111120命名规范.....可渎性.........变S、结构.函数、讨程.2225质S保证27代码编辑、编译、审查33代码测试、维护34宏(适用于C/C++)35修改建议:<注释应该规范一下格式,比如文件注释用块语句注释用//之类,重要的是要留下编码人员的姓名和吋间,便于问题跟踪今针对异常处理的规范令程序效率的问题很难,不是简吊的代码走查就能检测的了的,这个不好度景今建议增加文档夹、娄、接口、方法的命名规则1.排版较长的语句(>80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适
2、当的缩进,使排版整齐,语句可读。示例:perm_count_msg.head•len=N07_T0_STAT_PERM_C0UNT_LEN+STAT_SIZE_PER_FRAM*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_
3、flag=((taskno4、ord[word_index].word_length)&&(j5、JECT));n7statflashactduration(statitem,frameid*STATTASKCHECKNUMBER+index,stat_object);不允许把多个短语句写在一行中,即一行只写一条语句。示例:如下例子不符合规范。rect.length=0;rect.width=0;应如下书写rect.length=0;rect.width=0;程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、c6、ase语句中的程序都要采用如上的缩进方式。示例:如下例子不符合规范。for(...){...//programcode}if(…){...//programcodevoidexample_fun(void){...//programcode应如下书写。for(...){•…//programcodeif(…){•…//programcodevoidexample_fun(void)•…//programcode在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如一〉),后不应加空格。说明7、:采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性足相对的,所以,在己经非常清晰的语句中没宥必要再留空格,如果语句已足够淸晰则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不必加空格,因为在C/C++语言中括号己经是最淸晰的标志了。在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格。给操作符留空格时不要连续留两个以上空格。示例:逗号、分号只在后面加空格。inta,b,c;比较操作符,赋值操作符n=”、"+=”,算术操作符”+”、"%”,逻辑操作符”&&”、V,位域操
4、ord[word_index].word_length)&&(j5、JECT));n7statflashactduration(statitem,frameid*STATTASKCHECKNUMBER+index,stat_object);不允许把多个短语句写在一行中,即一行只写一条语句。示例:如下例子不符合规范。rect.length=0;rect.width=0;应如下书写rect.length=0;rect.width=0;程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、c6、ase语句中的程序都要采用如上的缩进方式。示例:如下例子不符合规范。for(...){...//programcode}if(…){...//programcodevoidexample_fun(void){...//programcode应如下书写。for(...){•…//programcodeif(…){•…//programcodevoidexample_fun(void)•…//programcode在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如一〉),后不应加空格。说明7、:采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性足相对的,所以,在己经非常清晰的语句中没宥必要再留空格,如果语句已足够淸晰则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不必加空格,因为在C/C++语言中括号己经是最淸晰的标志了。在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格。给操作符留空格时不要连续留两个以上空格。示例:逗号、分号只在后面加空格。inta,b,c;比较操作符,赋值操作符n=”、"+=”,算术操作符”+”、"%”,逻辑操作符”&&”、V,位域操
5、JECT));n7statflashactduration(statitem,frameid*STATTASKCHECKNUMBER+index,stat_object);不允许把多个短语句写在一行中,即一行只写一条语句。示例:如下例子不符合规范。rect.length=0;rect.width=0;应如下书写rect.length=0;rect.width=0;程序块的分界符(如C/C++语言的大括号‘{’和‘}’)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、c
6、ase语句中的程序都要采用如上的缩进方式。示例:如下例子不符合规范。for(...){...//programcode}if(…){...//programcodevoidexample_fun(void){...//programcode应如下书写。for(...){•…//programcodeif(…){•…//programcodevoidexample_fun(void)•…//programcode在两个以上的关键字、变量、常量进行对等操作时,它们之间的操作符之前、之后或者前后要加空格;进行非对等操作时,如果是关系密切的立即操作符(如一〉),后不应加空格。说明
7、:采用这种松散方式编写代码的目的是使代码更加清晰。由于留空格所产生的清晰性足相对的,所以,在己经非常清晰的语句中没宥必要再留空格,如果语句已足够淸晰则括号内侧(即左括号后面和右括号前面)不需要加空格,多重括号间不必加空格,因为在C/C++语言中括号己经是最淸晰的标志了。在长语句中,如果需要加的空格非常多,那么应该保持整体清晰,而在局部不加空格。给操作符留空格时不要连续留两个以上空格。示例:逗号、分号只在后面加空格。inta,b,c;比较操作符,赋值操作符n=”、"+=”,算术操作符”+”、"%”,逻辑操作符”&&”、V,位域操
此文档下载收益归作者所有