【文章內容簡介】 第 4 頁 共 69 頁 系統(tǒng)接口 ......................................................................................................................... 59 編程時，要防止差 1 錯誤 ................................................................................................ 61 操作符檢查 ..................................................................................................................... 61 分支語句寫完整 .............................................................................................................. 62 使用 return 語句 ............................................................................................................... 62 不要濫 用 goto 語句 .......................................................................................................... 62 其他 ................................................................................................................................ 62 11 代碼編輯、編譯、審查 ........................................................................................................... 65 打開編譯器的所有告警開關對程序進行編譯 .................................................................... 65 在產品軟件（項目組）中，要統(tǒng)一編譯開關選項 ............................................................. 65 通過代 碼走讀及審查方式對代碼進行檢查。 .................................................................... 65 測試部測試產品之前，應對代碼進行抽查及評審 ............................................................. 65 其他 ................................................................................................................................ 65 12 代碼測試、維護 ..................................................................................................................... 67 單元測試要求至少達到語句覆蓋 ...................................................................................... 67 單元測 試開始要跟蹤每一條語句，并觀察數據流及變量的變化 ........................................ 67 清理、整理或優(yōu)化后的代碼要經過審查及測試。 ............................................................. 67 代碼版本升級要經過嚴格測試 ......................................................................................... 67 使用工具軟件對代碼版本進行維護 .................................................................................. 67 正式版本上軟件的任何修改都應有詳細的文檔記錄 .......................................................... 67 其他 ................................................................................................................................ 67 13 宏 .......................................................................................................................................... 68 用宏定義表達式時，要使用完備的括號 ........................................................................... 68 將宏所定義的多條表達式放在大括號中 ........................................................................... 68 使用宏時，不允許參數發(fā)生變化 ...................................................................................... 69 第 5 頁 共 69 頁 1 概述 編寫目的 為規(guī)范軟件開發(fā)人員的代碼編寫提供參考依據和統(tǒng)一標準。 文檔約定 說明本文檔中所用到的專用術語定義或解釋，縮略詞定義。 預期的讀者和閱讀建議 本文檔適用于所有軟件開發(fā)人員。 參考文獻 列出有關的參考文件，如： a．屬于本項目的其他已發(fā)表文件； b．本文件中各處引用的 文檔 資料。 列出這些文件的標題、 作者 ，說明能夠得到這些文件資料的來源。 2 排版要求 程序塊縮進 程序塊要采用縮進風格編寫，縮進的空格數 為 4 個。 說明：對于由開發(fā)工具自動生成的代碼可以有不一致。 程序塊之間空行 相對獨立的程序塊之間、變量說明之后必須加空行。 示例：如下例子不符合規(guī)范。 if (!valid_ni(ni)) { ... // program code 第 6 頁 共 69 頁 } repssn_ind = ssn_data[index].repssn_index。 repssn_ni = ssn_data[index].ni。 應如下書寫 if (!valid_ni(ni)) { ... // program code } repssn_ind = ssn_data[index].repssn_index。 repssn_ni = ssn_data[index].ni。 長語句和長表達式 較長的語句（ 80字符）要分成多行書寫，長表達式要在低優(yōu)先級操作符處劃分新行，操作符放在新行之首，劃分出的新行要進行適當的縮進，使排版整齊，語句可讀。 示例： = 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) amp。amp。 (n7stat_stat_item_valid (stat_item)) amp。amp。 (act_task_table[taskno].result_data != 0))。 第 7 頁 共 69 頁 循環(huán)、判斷等長表達式或語句 循環(huán)、判斷等語句中若有較長的表達式或語句，則要進行適應的劃分，長表達式要在低優(yōu)先級操作符處劃分新行，操作符放在新行之首。 示例： if ((taskno max_act_task_number) amp。amp。 (n7stat_stat_item_valid (stat_item))) { ... // program code } for (i = 0, j = 0。 (i BufferKeyword[word_index].word_length) amp。amp。 (j )。 i++, j++) { ... // program code } for (i = 0, j = 0。 (i first_word_length) amp。amp。 (j second_word_length)。 i++, j++) { ... // program code } 長參數 若函數或過程中的參數較長，則要進行適當的劃分。 示例： n7stat_str_pare((BYTE *) amp。 stat_object, (BYTE *) amp。 (act_task_table[taskno].stat_object), sizeof (_STAT_OBJECT))。 第 8 頁 共 69 頁 n7stat_flash_act_duration( stat_item, frame_id *STAT_TASK_CHECK_NUMBER + index, stat_object )。 短語句 不允許把多個短語句寫在一行中，即一行只寫一條語句。 示例：如下例子不符合規(guī)范。 = 0。 = 0。 應如下書寫 = 0。 = 0。 條件、循環(huán)語句 if、 for、 do、 while、 case、 switch、 default等語句自占一行，且 if、 for、 do、 while等語句的執(zhí)行語句部分無論多少都要加括號 {}。 示例：如下例子不符合規(guī)范。 if (pUserCR == NULL) return。 應如 下書寫： if (pUserCR == NULL) { return。 } 語句對齊 對齊只使用空格鍵，不使用 TAB鍵。 說明：以免用不同的編輯器閱讀程序時，因 TAB鍵所設置的空格數目不同而造成程序