公司程序培訓(xùn)教材

1、1 / 138目錄1排版62注釋113標(biāo)識符命名184可讀性205變量、結(jié)構(gòu)226函數(shù)、過程287可測性368程序效率409質(zhì)量保證4410代碼編輯、 編譯、審查5011代碼測試、 維護5212宏532 / 1381排版11-1：程序塊要采納縮進風(fēng)格編寫，縮進的空格數(shù)為4個講明：關(guān)于由開發(fā)工具自動生成的代碼能夠有不一致。11-2：相對獨立的程序塊之間、變量講明之后必須加空行。 示例：如下例子不符合規(guī)范。if (!valid_ni(ni). / program coderepssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_datainde

2、x.ni;應(yīng)如下書寫if (!valid_ni(ni). / program code3 / 138repssn_ind = ssn_dataindex.repssn_index;repssn_ni = ssn_dataindex.ni;11-3：較長的語句(80字符)要分成多行書寫，長表達式要在低 優(yōu)先級操作符處劃分新行， 操作符放在新行之首， 劃分出的新行要 進行適當(dāng)?shù)目s進，使排版整齊，語句可讀。示例：perm_count_msg.head.len = NO7_TO_STAT_PERM_COUNT_LEN+ STAT_SIZE_PER_FRAM *sizeof( _UL );act_tas

3、k_tableframe_id * STAT_TASK_CHECK_NUMBER +index.occupied4 / 138= stat_poiindex.occupied;act_task_tabletaskno.duration_true_or_falseSYS_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

4、 != 0);11-4：循環(huán)、推斷等語句中若有較長的表達式或語句，則要進行適 應(yīng)的劃分， 長表達式要在低優(yōu)先級操作符處劃分新行， 操作符放在 新行之首。示例：if (taskno max_act_task_number)& (n7stat_stat_item_valid (stat_item)5 / 138. / program codefor (i = 0, j = 0; (i BufferKeywordword_index.word_length)& (j NewKeyword.word_length); i+,j+). / program codefor (i = 0,

5、j = 0;(i first_word_length) &(j second_word_length); i+, j+). / program code6 / 13811-5：若函數(shù)或過程中的參數(shù)較長，則要進行適當(dāng)?shù)膭澐?。示例：n7stat_str_compare(BYTE *) & stat_object,(BYTE *) &(act_task_tabletaskno.stat_object),sizeof (_STAT_OBJECT);n7stat_flash_act_duration( stat_item, frame_id*STAT_TASK_CHECK_NUM

6、BER+ index,stat_object );11-6：不同意把多個短語句寫在一行中，即一行只寫一條語句示例：如下例子不符合規(guī)范。rect.length = 0; rect.width = 0;7 / 138應(yīng)如下書寫rect.length = 0;rect.width = 0;11-7：if、for、do、while、case、switch、default等語句自占 一行，且if、for、do、while等語句的執(zhí)行語句部分不管多少都要 加括號。示例：如下例子不符合規(guī)范。if (pUserCR = NULL) return;應(yīng)如下書寫：if (pUserCR = NULL)return;11-8:對齊只使用空格鍵，不使用TAB鍵