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

程序設(shè)計(jì)語(yǔ)言編碼規(guī)范江蘇微軟技術(shù)中心編碼規(guī)范之排版第三章

教學(xué)內(nèi)容

編碼規(guī)范的排版規(guī)范。為什么要有排版？

示例１：一篇新聞稿為什么要有排版？

示例２：一篇新聞稿為什么要有排版？從這兩個(gè)示例中，可以明顯得出，文檔需要排版，各段落講述各自的內(nèi)容。這是在小學(xué)語(yǔ)文中就強(qiáng)調(diào)的習(xí)慣和規(guī)范。顯然，編碼也需要排版，否則所有代碼連在一起，結(jié)果可想而知。。。。。。排版規(guī)范1.程序塊要采用縮進(jìn)風(fēng)格編寫(xiě)，縮進(jìn)的空格數(shù)為4個(gè)。說(shuō)明：對(duì)于由開(kāi)發(fā)工具自動(dòng)生成的代碼，可能在縮進(jìn)空格數(shù)上不一致.需要進(jìn)行調(diào)整或統(tǒng)一進(jìn)行約定采用自動(dòng)生成的格式。排版規(guī)范2.相對(duì)獨(dú)立的程序塊之間、變量聲明之后必須加空行。示例：如下例子不符合規(guī)范。if(!valid_ni(ni)){...//programcode}repssn_ind=ssn_data[index].repssn_index;repssn_ni=ssn_data[index].ni;排版規(guī)范應(yīng)按規(guī)范格式書(shū)寫(xiě)如下：if(!valid_ni(ni)){...//programcode}

repssn_ind=ssn_data[index].repssn_index;repssn_ni=ssn_data[index].ni;排版規(guī)范3.較長(zhǎng)的語(yǔ)句（>80字符）要分成多行書(shū)寫(xiě)，長(zhǎng)表達(dá)式要在低優(yōu)先級(jí)操作符處劃分新行，操作符放在新行之首，劃分出的新行要進(jìn)行適當(dāng)?shù)目s進(jìn)，使排版整齊，語(yǔ)句可讀。排版規(guī)范示例：perm_count_msg.head.len=NO7_TO_STAT_PERM_COUNT_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_flag=((taskno<MAX_ACT_TASK_NUMBER)&&(n7stat_stat_item_valid(stat_item))&&(act_task_table[taskno].result_data!=0));排版規(guī)范4.循環(huán)、判斷等語(yǔ)句中若有較長(zhǎng)的表達(dá)式或語(yǔ)句，則要進(jìn)行適應(yīng)的劃分，長(zhǎng)表達(dá)式要在低優(yōu)先級(jí)操作符處劃分新行，操作符放在新行之首。排版規(guī)范if((taskno<max_act_task_number)&&(n7stat_stat_item_valid(stat_item))){...//programcode}

for(i=0,j=0;(i<BufferKeyword[word_index].word_length)&&(j<NewKeyword.word_length);i++,j++){...//programcode}

for(i=0,j=0;(i<first_word_length)&&(j<second_word_length);i++,j++){...//programcode}排版規(guī)范5.若函數(shù)或過(guò)程中的參數(shù)較長(zhǎng)，則要進(jìn)行適當(dāng)?shù)膭澐?。排版?guī)范示例：/***GetCustomSerializer*/publicstaticorg.apache.axis.encoding.SerializergetSerializer(java.lang.StringmechType,

java.lang.Class_javaType,

space.QName_xmlType){

return

neworg.apache.axis.encoding.ser.BeanSerializer(

_javaType,_xmlType,typeDesc);

}publicstaticSerializergetSerializer(java.lang.StringmechType,

java.lang.Class_javaType,

space.QName_xmlType)排版規(guī)范6.不允許把多個(gè)短語(yǔ)句寫(xiě)在一行中，即一行只寫(xiě)一條語(yǔ)句。示例：如下例子不符合規(guī)范。rect.length=0;rect.width=0;

應(yīng)如下書(shū)寫(xiě)rect.length=0;rect.width=0;排版規(guī)范7.if、for、do、while、case、switch、default等語(yǔ)句自占一行，且if、for、do、while等語(yǔ)句的執(zhí)行語(yǔ)句部分無(wú)論多少都要加括號(hào){}。示例：如下例子不符合規(guī)范。if(pUserCR==NULL)return;

應(yīng)如下書(shū)寫(xiě)：if(pUserCR==NULL){return;}排版規(guī)范8.對(duì)齊只使用空格鍵，不使用TAB鍵。說(shuō)明：當(dāng)使用不同的編輯器閱讀程序時(shí)，因TAB鍵所設(shè)置的空格數(shù)目不同而造成程序布局不整齊。排版規(guī)范9.程序塊的分界符（如C/C++語(yǔ)言的大括號(hào)‘{’和‘}’）應(yīng)各獨(dú)占一行并且位于同一列，同時(shí)與引用它們的語(yǔ)句左對(duì)齊。在函數(shù)體的開(kāi)始、類(lèi)的定義、結(jié)構(gòu)的定義、枚舉的定義以及if、for、do、while、switch、case語(yǔ)句中的程序都要采用如上的縮進(jìn)方式。在java語(yǔ)言中，也可采用緊縮格式。排版規(guī)范示例：如下例子不符合規(guī)范。for(...){...//programcode}

if(...){...//programcode}

voidexample_fun(void){...//programcode}Java語(yǔ)言緊縮格式排版規(guī)范應(yīng)如下書(shū)寫(xiě)。for(...){...//programcode}

if(...){

if(....){...//programcode}}

voidexample_fun(intinval){...//programcode}本章總結(jié)縮進(jìn)與對(duì)