第三章 編碼規(guī)范之排版

1、第三章編碼規(guī)范的排版規(guī)范。編碼規(guī)范的排版規(guī)范。 示例：一篇新聞稿示例：一篇新聞稿 示例：一篇新聞稿示例：一篇新聞稿 從這兩個示例中，可以明顯得出，文檔需要排版，各段落講述各自的內(nèi)容。這是在小學(xué)語文中就強調(diào)的習(xí)慣和規(guī)范。 顯然，編碼也需要排版，否則所有代碼連在一起，結(jié)果可想而知。 1.程序塊要采用縮進風格編寫，縮進的空格程序塊要采用縮進風格編寫，縮進的空格數(shù)為數(shù)為4個。個。 說明：對于由開發(fā)工具自動生成的代碼，說明：對于由開發(fā)工具自動生成的代碼，可能在縮進空格數(shù)上不一致可能在縮進空格數(shù)上不一致.需要進行調(diào)整需要進行調(diào)整或統(tǒng)一進行約定采用自動生成的格式?；蚪y(tǒng)一進行約定采用自動生成的格式。 2.相對

2、獨立的程序塊之間、變相對獨立的程序塊之間、變量聲明之后必須加空行。量聲明之后必須加空行。 示例：如下例子不符合示例：如下例子不符合規(guī)規(guī)范。范。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; ;應(yīng)應(yīng)按按規(guī)規(guī)范格式范格式書寫書寫如下：如下：

3、if (!valid_ni(ni) . / program coderepssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni; 3.較長的語句（80字符）要分成多行書寫，長表達式要在低優(yōu)先級操作符處劃分新行，操作符放在新行之首，劃分出的新行要進行適當?shù)目s進，使排版整齊，語句可讀。示例：示例：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.循環(huán)、

5、判斷等語句中若有較長的表達式或語句，則要進行適應(yīng)的劃分，長表達式要在低優(yōu)先級操作符處劃分新行，操作符放在新行之首。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.若函數(shù)或過程中的參數(shù)較長，則要進行適當?shù)膭澐帧Ｊ纠菏纠?* * 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.不允許把多個短語句寫在一行中，即一行只寫一條語句。示例：如下例子不符合規(guī)范。rect.length = 0; rect.width = 0;應(yīng)如下書寫rect.length = 0;rect.width = 0; 7.if、for、do、while、case、switch、default等語句自占一行自占一行，

9、且if、for、do、while等語句的執(zhí)行語句部分無論多少都要加括號都要加括號。 示例：如下例子不符合規(guī)范。if (pUserCR = NULL) return; 應(yīng)如下書寫：if (pUserCR = NULL) return; 8.對齊只使用空格鍵，不使用TAB鍵。 說明：當使用不同的編輯器閱讀程序時，因TAB鍵所設(shè)置的空格數(shù)目不同而造成程序布局不整齊。 9.程序塊的分界符（如C/C+語言的大括號和）應(yīng)各獨占一行并且位于同一列，同時與引用它們的語句左對齊。在函數(shù)體的開始、類的定義、結(jié)構(gòu)的定義、枚舉的定義以及if、for、do、while、switch、case語句中的程序都要采用如上的縮

10、進方式。 在java語言中，也可采用緊縮格式。示例：如下例子不符合規(guī)范。for (.) . / program codeif (.) . / program code void example_fun( void ) . / program code Java語言緊縮格式語言緊縮格式應(yīng)應(yīng)如下如下書寫書寫。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個字符的語句個字