【正文】 or 應如下書寫//get replicate sub system index and net indicator ucRepssnInd = aucSsnData[ucIndex].ucRepssnIndex。s unit data transmission request}。示例（注意斜體加粗部分）：case CMD_UP: ProcessUp()。 break。1通過正確命名使代碼成為自注釋的通過對函數或過程、變量、結構等正確的命名以及合理地組織代碼的結構，使代碼成為自注釋的。說明：注釋語言不統(tǒng)一，影響程序易讀性和外觀排版，出于對維護人員的考慮，建議使用中文。 d)) (3)如果書寫為high 8 | lowa | b amp。amp。if (Trunk[index].trunk_state == 0){ Trunk[index].trunk_state = 1。 = 10。* ++ stat_poi += 1。五、變量，結構 公共變量、去掉沒必要的公共變量說明：公共變量是增大模塊間耦合的原因之一，故應減少沒必要的公共變量以降低模塊間的耦合度。、要謹慎向公共變量傳遞數據 當向公共變量傳遞數據時，要十分小心，防止賦與不合理的值或越界等現象發(fā)生。說明：使用標準的數據類型，有利于程序的移植。數組、數組大小及初始值要明確定義 數組初始化不要采用系統(tǒng)默認值，最好能夠采用初始化語句來完成、數組、結構和聯合的初始化列表應顯式描述 數組、結構和聯合的初始化列表應使用大括號，并使用附加的大括號來指示嵌套的結構；程序員應顯式地考慮和描述復雜數據類型的所有元素，不應忽略某個元素的初始化。s name unsigned char ucAge。 // his teacher sex } STUDENT。s name unsigned char ucAge。、不同結構間的關系不要過于復雜說明：若兩個結構間關系較復雜、密切，那么應合為一個結構。 unsigned char ucAge。 unsigned char aucCity[15]。 unsigned char ucSex。} PERSON。若改成如下形式，不僅可節(jié)省1字節(jié)空間，可讀性也變好了。、跨平臺數據結構，要考慮字節(jié)順序及對齊問題當聲明用于分布式環(huán)境或不同CPU間通信環(huán)境的數據結構時，必須考慮機器的字節(jié)順序、使用的位域及字節(jié)對齊等問題 。如下是Intel CPU生成短整數及位域的方式。注意其命名方式在同一產品中的統(tǒng)一。typedef float DISTANCE。chr = 1。 void f(void) { int a。uiPointTmp。、只有指向同一數組的兩個指針才允許相減此處兩個指針可以指向同一數組的不同成員錯誤用法示例： uint auiArray[10]。 uint uiTemp。、指針的索引值不應為負、不應對指針值可能為NULL的指針進行算術運算 、調用返回類型為指針的函數后，應進行是否為空的判斷、局部變量的地址不應在本對象消亡后傳給另外一個對象本條要求分為以下幾種情況：a、 將動態(tài)分配的局部變量的地址賦值給一個帶鏈接的或更寬范圍的指針是危險的，一旦局部變量的內存空間被釋放，這個指針會成為無效的指針（見示例1）；b、 函數參數不應返回動態(tài)數據的地址（見示例2）；c、 函數參數不應返回本地靜態(tài)數據的地址（見示例3）。 return。 ... *puiApp = amp。void TMP_Test(void){ uint uiTemp。正確用法示例： uchar aucArray[10]。 puiFirst = auiArray+3 ++puiPoint。a。 // 編譯器不產生告警，此時exam為0xFFFF。類型轉換、謹慎使用數據類型的強制轉換 編程時，要注意數據類型的強制轉換。示例：可參考如下方式聲明自定義數據類型。內存： 0 1 2 ... （從低到高，以字節(jié)為單位）exam exam高字節(jié) exam低字節(jié)內存： 7 bit 6 bit 5 bit ... （字節(jié)的各“位”）EXAM_BIT A1 A2 A3說明：在對齊方式下，CPU的運行效率要快得多。示例：假如有如下短整數及結構。 unsigned int uiSetFlg: 1。說明：合理排列結構中元素順序，可節(jié)省空間并增加可理解性。typedef struct PERSON_ADDRESS_STRU{ unsigned char ucAddr[40]。} PERSON。} PERSON_TWO。typedef struct PERSON_ONE_STRU{ unsigned char aucName[8]。s age unsigned char ucSex。typedef struct TEACHER_STRU{ unsigned char aucName[8]。s age unsigned char ucSex。 int16_t y[3][2] = { {1, 2} }。 int　length, width, i, j, k。、防止局部變量與公共變量同名。、明確公共變量與操作此公共變量的函數或過程的關系 明確公共變量與操作此公共變量的函數或過程的關系，如訪問、修改及創(chuàng)建等。*stat_poi += 1。 // 矩形的長與寬關系較密切，放在一起。 ... // program code}源程序中關系較為緊密的代碼應盡可能相鄰說明：便于程序閱讀和查找。 c)，(1)(2)不會出錯，但語句不易理解；a | b c amp。 a amp。例如：來注釋一段較大的代碼if 0define DISP_TBL_SIZE 5 //Sizeofdisplaybuffertabledefine DISP_MAX_X 80 //define DISP_MAX_Y 25 //define DISP_MASK 0x5Fendif注釋不能嵌套四、代碼可讀性使用小括號明確表達式的操作順序注意運算符的優(yōu)先級，并用括號明確表達式的操作順序，避免使用默認優(yōu)先級。示例：如下注釋意義不大。 break。case CMD_DOWN: ProcessDown()。注釋要與說描述的內容進行同樣的縮排說明：可使程序排版整齊，并方便注釋的閱讀與理解。變量、常量命名不能充分自注釋的，必須加以注釋對于所有有物理含義的變量、常量，如果其命名不是充分自注釋的，在聲明時都必加注釋，說明其物理含義。注釋書寫位置注釋應與其描述的代碼相近，對代碼的注釋應放在其上方或右方（對單條語句的注釋）相鄰位置，不可放在下面，如放于上方則需與其上面的代碼用空行隔開。函數功能：該函數實現的具體功能，具有依賴關系的函數間在此進行說明。 }(10)、對于表達式比較長的for語句和if語句，為了緊湊起見可以適當地去掉一些空格 例如：for (i=0。 // 非操作!與內容之間p = amp。if (current_time = MAX_TIME_VALUE) a = b + c。’向前緊跟，緊跟處不留空格。for (...) { ... // program code}if (...) { ... // program code }void example_fun( void ) { ... // program code }應如下書寫。即使預處理指令位于縮進代碼塊中，指令也應從行首開始 示例：良好風格：預處理指令均從行首開始if (lopsided_score) {if DISASTER_PENDING // Correct Starts at beginning of line DropEverything()。 = 0。 i++, j++){ ... // program code}for (i=0, j=0。長表達式換行循環(huán)、判斷等語句中若有較長的表達式或語句，則要進行適應的劃分，長表達式要在低優(yōu)先級操作符處劃分新行，操作符放在新行之首。 }}if ((ucCount == 1) amp。 (ucRetCode == 0)){ *pucErrCode = EPRONTCENTER。if ((ucCount == 1) amp。二、排版縮進風格 程序塊要采用縮進風格編寫，縮進的空格數為4個。避免使用以下劃線開始和結尾的定義 除了編譯開關/頭文件等特殊應用，應避免使用_EXAMPLE_TEST_之類以下劃線開始和結尾的定義程序中不要出現僅靠大小寫區(qū)分的相似的標識符 例如：　　uint　uix,　uiX。不要用數字或較奇怪的字符來定義標識符 示例：如下命名，使人產生疑惑。六、命名注意事項：標識符命名基本原則標識符的命名要清晰、明了，有明確含義，同時使用完整的單詞或大家基本可以理解的縮寫，避免使人產生誤解。二、變量命名規(guī)則局部變量命名：格式如下：序號說明字體選擇備注1變量類型簡寫小寫必選以最直觀模式給用戶區(qū)分不同的變量類型，最多2個字母長度，具體參考《附錄A 常用變量類型及簡寫》2變量修飾首字母大寫可選修飾詞英文名稱或者簡寫，最多2個單詞3變量名稱首字母大寫必選名稱英文名稱或者簡寫，最多2個單詞例如：uchar ucCurrentValue。函數體： 可參考模塊《》文件結束說明主要包含：文件結束說明：End Of File可參考模塊《》二、h文件格式說明文件創(chuàng)建及修改說明區(qū)主要包含：公司信息：公司名稱、公司網站。修改信息：修改者名稱，修改日期，修改后版本號，修改內容描述。 公共變量僅由模塊或函數創(chuàng)建和修改，其余模塊和函數只能訪問 40局部變量 4嚴禁使用未經初始化的變量作為右值 4不使用與硬件或軟件環(huán)境關系密切的變量 4變量聲明時，同一類型，不同意義的多個變量，要分行，便于區(qū)分 4對只設置一次的變量，宜使用“const”限定詞進行聲明 4避免在函數中使用 static 局部變量 41數組 4數組大小及初始值要明確定義 4數組、結構和聯合的初始化列表應顯式描述 41結構、聯合 4結構的功能要單一，是針對一種事務的抽象 4不要設計面面俱到、非常靈活的數據結構 4不同結構間的關系不要過于復雜 4結構中元素的個數應適中 4結構體中元素的布局 4結構體設計要考慮兼容性 4跨平臺數據結構，要考慮字節(jié)順序及對齊問題 4struct或union類型中至少應有一個成員 4struct或union類型的成員類型 46枚舉 4枚舉元素的初始化應完整 47自定義數據類型 4合理地設計數據并使用自定義數據類型 4自定義數據類型命名要恰當 47類型轉換 4謹慎使用數據類型的強制轉換 4了解編譯系統(tǒng)默認的數據類型轉換 4應禁止 signed 類型與 unsigned 類型之間的隱式轉化 4應禁止 int 類型與 float 類型的隱式轉化 48指針 4不應對指針變量使用強制類型轉換賦值 4不應把自動類型的局部變量的地址賦值給外部指針 4指針的指針不應超過兩級 4指向不同數據類型的指針之間不應相互轉換 4指針轉換過程中不應丟失指針的const、 volatile屬性 4只有指向數組的指針才允許進行算術運算 4只有指向同一數組的兩個指針才允許相減 4只有指向同一數組的兩個指針才允許用、=、和=等關系運算符進行比較 4指針的索引值不應為負 50、不應對指針值可能為NULL的指針進行算術運算 50、調用返回類型為指針的函數后，應進行是否為空的判斷 50、局部變量的地址不應在本對象消亡后傳給另外一個對象 50、一個未知大小的對象的指針不應成為加法或者減法操作的左操作數 51六、函數 51函數編寫原則 5明確函數功能，精確（而不是近似）地實現函數設計 5函數的規(guī)模盡量限制在200行以內 5一個函數僅完成一件功能 5為簡單功能編寫函數 5不要設計多用途面面俱到的函數 5函數功能具有可預測性 5函數功能具有獨立性 5防止函數出現隨機內聚 5功能不明確的較小函數，可以不必存在 5設計高扇入、合理扇出（小于7）的函數 5減少函數本身或函數間的遞歸調用 54