第三章 编码规范之排版

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个字符的语句个字