第三章 编码规范之排版_第1页
第三章 编码规范之排版_第2页
第三章 编码规范之排版_第3页
第三章 编码规范之排版_第4页
第三章 编码规范之排版_第5页
已阅读5页,还剩18页未读 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

1、第三章编码规范的排版规范。编码规范的排版规范。 示例:一篇新闻稿示例:一篇新闻稿 示例:一篇新闻稿示例:一篇新闻稿 从这两个示例中,可以明显得出,文档需要排版,各段落讲述各自的内容。这是在小学语文中就强调的习惯和规范。 显然,编码也需要排版,否则所有代码连在一起,结果可想而知。 1.程序块要采用缩进风格编写,缩进的空格程序块要采用缩进风格编写,缩进的空格数为数为4个。个。 说明:对于由开发工具自动生成的代码,说明:对于由开发工具自动生成的代码,可能在缩进空格数上不一致可能在缩进空格数上不一致.需要进行调整需要进行调整或统一进行约定采用自动生成的格式。或统一进行约定采用自动生成的格式。 2.相对

2、独立的程序块之间、变相对独立的程序块之间、变量声明之后必须加空行。量声明之后必须加空行。 示例:如下例子不符合示例:如下例子不符合规规范。范。if (!if (!valid_nivalid_ni( (nini) . / program code . / program code repssn_indrepssn_ind = = ssn_datassn_dataindex.index.repssn_indexrepssn_index; ;repssn_nirepssn_ni = = ssn_datassn_dataindex.index.nini; ;应应按按规规范格式范格式书写书写如下:如下:

3、if (!valid_ni(ni) . / program coderepssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni; 3.较长的语句(80字符)要分成多行书写,长表达式要在低优先级操作符处划分新行,操作符放在新行之首,划分出的新行要进行适当的缩进,使排版整齐,语句可读。示例:示例:perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN + STAT_SIZE_PER_FRAM * sizeof( _UL );act_task_tableframe_id *

4、 STAT_TASK_CHECK_NUMBER + index .occupied = stat_poiindex.occupied;act_task_tabletaskno .duration_true_or_false = SYS_get_sccp_statistic_state( stat_item );report_or_not_flag = (taskno MAX_ACT_TASK_NUMBER) & (n7stat_stat_item_valid (stat_item) & (act_task_tabletaskno.result_data != 0); 4.循环、

5、判断等语句中若有较长的表达式或语句,则要进行适应的划分,长表达式要在低优先级操作符处划分新行,操作符放在新行之首。if (if (tasknotaskno max_act_task_numbermax_act_task_number) ) & (n7stat_stat_item_valid ( & (n7stat_stat_item_valid (stat_itemstat_item) . / program codefor (i = 0, j = 0; (i for (i = 0, j = 0; (i BufferKeywordBufferKeyword word_index

6、word_index.word_lengthword_length) ) & (j & (j NewKeyword.word_lengthNewKeyword.word_length); i+, j+); i+, j+) . / program codefor (for (i i = 0, j = 0; = 0, j = 0; (i (i first_word_lengthfirst_word_length) & (j ) & (j second_word_lengthsecond_word_length); ); i+, j+) i+, j+) . / pro

7、gram code 5.若函数或过程中的参数较长,则要进行适当的划分。示例:示例:/* * Get Custom Serializer */public static org.apache.axis.encoding.Serializer getSerializer( java.lang.String mechType, java.lang.Class _javaType, space.QName _xmlType) return new org.apache.axis.encoding.ser.BeanSerializer( _javaType, _xmlType

8、, typeDesc); public static Serializer getSerializer(java.lang.String mechType, java.lang.Class _javaType, space.QName _xmlType) 6.不允许把多个短语句写在一行中,即一行只写一条语句。示例:如下例子不符合规范。rect.length = 0; rect.width = 0;应如下书写rect.length = 0;rect.width = 0; 7.if、for、do、while、case、switch、default等语句自占一行自占一行,

9、且if、for、do、while等语句的执行语句部分无论多少都要加括号都要加括号。 示例:如下例子不符合规范。if (pUserCR = NULL) return; 应如下书写:if (pUserCR = NULL) return; 8.对齐只使用空格键,不使用TAB键。 说明:当使用不同的编辑器阅读程序时,因TAB键所设置的空格数目不同而造成程序布局不整齐。 9.程序块的分界符(如C/C+语言的大括号和)应各独占一行并且位于同一列,同时与引用它们的语句左对齐。在函数体的开始、类的定义、结构的定义、枚举的定义以及if、for、do、while、switch、case语句中的程序都要采用如上的缩

10、进方式。 在java语言中,也可采用紧缩格式。示例:如下例子不符合规范。for (.) . / program codeif (.) . / program code void example_fun( void ) . / program code Java语言紧缩格式语言紧缩格式应应如下如下书写书写。for (.) for (.) . / program code . / program code if (.) if (.) if(.) if(.) . / program code . / program code void void example_funexample_fun( ( intint invalinval ) ) . / program code . / program code 缩进与对齐缩进与对齐 程序块缩进程序块缩进4个个空格空格 要按语句块各要按语句块各自对齐自对齐换行换行 相对独立的程序块之间相对独立的程序块之间 大于大于80个字符的语句个字

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论