【正文】 }示例3：void TMP_Test(uint *puiApp){ static uint uiTemp = 1。錯誤用法示例：示例1：extern uint* puiTest。 uiTemp = aucFirst aucSecond。 uint uiTmp, *puiFirst, *puiSecond。 puiPoint = puiPoint + 2。 pi = amp。exam = chr。typedef float SCORE。說明：使用自定義類型，可以彌補編程語言提供類型少、信息量不足的缺點，并能使程序清晰、簡潔。內存： 0 1 2 ... （從低到高，以字節(jié)為單位）exam exam低字節(jié) exam高字節(jié)內存： 0 bit 1 bit 2 bit ... （字節(jié)的各“位”）EXAM_BIT A1 A2 A3如下是68360 CPU生成短整數(shù)及位域的方式。說明：比如Intel CPU與68360 CPU，在處理位域及整數(shù)時，其在內存存放的“順序”正好相反。typedef struct EXAMPLE_STRU{ unsigned int uiValid: 1。、結構體中元素的布局 仔細設計結構中元素的布局與排列順序，使結構容易理解、節(jié)省占用空間，并減少引起誤用現(xiàn)象。} PERSON_BASE_INFO。 unsigned char ucTel。 unsigned char ucTel。示例：如下兩個結構的構造不合理。 // student39。若改為如下，可能更合理些。 //student39。 例如：錯誤用法 int16_t y[3][2] = { 1, 2, 3, 4, 5, 6 }。、變量聲明時，同一類型，不同意義的多個變量，要分行，便于區(qū)分 示例：以下代碼中，i,j,k是臨時循環(huán)變量，與有實際意義的lenth,width放一起不太合理。說明：對公共變量賦值時，若有必要應進行合法性檢查，以提高代碼的可靠性、穩(wěn)定性。、仔細定義并明確公共變量的含義、作用、取值范圍及公共變量間的關系說明：在對變量聲明的同時，應對其含義、作用及取值范圍進行注釋說明，同時若有必要還應說明與其它變量的關系。應分別改為如下。 = 5。 ... // program code}應改為如下形式： define TRUNK_IDLE 0define TRUNK_BUSY 1if (Trunk[index].trunk_state == TRUNK_IDLE){ Trunk[index].trunk_state = TRUNK_BUSY。 (a amp。amp。1使用 if0和 endif注釋代碼塊 使用 if0和 endif注釋代碼塊。說明：清晰準確的函數(shù)、變量等的命名，可增加代碼可讀性，并減少不必要的注釋1在代碼的功能、意圖層次上進行注釋，提供有用、額外的信息 說明：注釋的目的是解釋代碼的目的、功能和采用的方法，提供代碼以外的信息，幫助讀者理解代碼，防止沒必要的重復注釋信息。case CMD_B: ProcessB()。 break。全局變量注釋全局變量要有較詳細的注釋，包括對其功能、取值范圍、以及存取時注意事項等的說明。ucRepssnNi = aucSsnData[ucIndex].ucNi。避免在注釋中使用縮寫，特別是非常用縮寫說明：在使用縮寫時或之前，應對縮寫進行必要的說明。函數(shù)的頭部注釋要達到調用無需瀏覽函數(shù)，從注釋區(qū)就能夠了解該函數(shù)的全部信息。 char *get_string() { char *str。 // 內容操作*與內容之間flag = !isEmpty?！薄ⅰ皘|”、“”,“^”等二元操作符的前后應當加一個 空格。(2)、函數(shù)名之后不要留空格，緊跟左括號‘(’，以與關鍵字區(qū)別(3)、‘(’向后緊跟，‘)’、‘,’、‘。示例：如下例子不符合規(guī)范。預處理指令不需要縮進，總是從行首開始。 應如下書寫 = 0。 (j )。 aucTaskTable[ucFrameId * TMP_STAT_TASK_CHECK_NUMBER + ucIndex] = astAtPoi[ucIndex].ucStatus。 return EPRONTCENTER。amp。程序文件結構各部分之間空兩行，若不必要也可只空一行，各函數(shù)實現(xiàn)之間一般空兩行 示例：如下例子不符合規(guī)范。保持代碼語句和結構簡單清晰，避免使用復雜語句。uint TMP_DeleteUser(uchar *pucUserName )。局部循環(huán)變量也必須按照變量命名規(guī)則來定義說明：變量，尤其是局部變量，如果用單個字符表示，很容易敲錯（如i寫成j），而編譯時又檢查不出來，有可能為了這個小小的錯誤而花費大量的查錯時間。三、宏命名規(guī)則格式如下：序號說明字體選擇備注1模塊名稱大寫必選以最直觀模式給用戶區(qū)分不同的模塊宏，采用模塊英文名稱或者簡寫2下劃線必選間隔符3功能名稱大寫必選功能英文名稱或者簡寫，最多2個單詞4下劃線可選間隔符5修飾詞大寫可選修飾詞英文名稱或者簡寫，最多2個單詞例如：define TMP_BUFF_MAX 256 //緩沖區(qū)最大長度四、文件命名規(guī)則格式如下（全部小寫）：序號說明字體選擇備注1模塊名稱小寫必選采用模塊英文名稱或者簡寫2下劃線可選_3分類名稱小寫可選分類英文名稱或者簡寫4頓號必選.5文件類型小寫必選代碼文件（c），頭文件（h）例如：液晶模塊： 按鍵模塊： 五、新定義變量類型命名規(guī)則 新定義變量類型對變量進行命名時可以提出2個與其他類型不相同的字母前綴來表示，并在文件開始或者新類型定義時進行說明?？蓞⒖寄K《》1文件結束說明主要包含：文件結束說明：End Of File可參考模塊《》第三章、命名規(guī)則一、函數(shù)命名規(guī)則格式如下：序號說明字體選擇備注1模塊名稱大寫必選以最直觀模式給用戶區(qū)分不同的模塊函數(shù)，采用模塊英文名稱或者簡寫2下劃線必選間隔符3函數(shù)動作首字母大寫必選動作英文名稱或者簡寫，最多2個單詞4函數(shù)對象首字母大寫可選對象英文名稱或者簡寫，最多2個單詞5函數(shù)范圍首字母大寫可選范圍英文名稱或者簡寫，最多2個單詞例如：LCD_DispWord，表示液晶模塊顯示漢字 函數(shù)命名的一個重要原則是望文知意（其他人看到函數(shù)名就大體知道函數(shù)功能），必須考慮命名的準確性，命名體現(xiàn)函數(shù)的功能，而不要體現(xiàn)函數(shù)的實現(xiàn)方法。函數(shù)體： 可參考模塊《》應用函數(shù)區(qū)主要包含：應用函數(shù)區(qū)說明注釋行：函數(shù)說明：包含函數(shù)功能說明，參數(shù)說明，返回值說明。創(chuàng)建信息：創(chuàng)建者名稱，創(chuàng)建日期，最初版本號，文檔內容描述。簡單功能的模塊采用一個c文件和h文件接口，復雜功能的模塊可能需要多個c文件和h文件?？蓞⒖寄K《》全局變量定義區(qū)主要包含：全局變量定義區(qū)說明注釋行：全局變量定義：要賦初值。自定義頭文件引用：文件名包含著雙引號中。例如：uchar *pucReceiveBuff[10]。 maxinformation”原則。示例：uint uiMinSum。常用單詞縮寫見《附錄B 常用單詞及縮寫》函數(shù)名應準確描述函數(shù)的功能避免使用無意義或含義不清的動詞為函數(shù)命名 說明：避免用含義不清的動詞如process、handle等為函數(shù)命名，因為這些動詞并沒有說明要具體做什么。可以采用空格鍵來替代，4個空格代替一個【TAB】鍵。) { *pucErrCode = 0。 (ucRetCode == 1)){ if (ucStatus == 39。}語句長度要小于80個字符 一行語句以小于80字符為宜，不要寫得過長。 (TMP_StatItemValid (ucStatItem))){ ... // program code}for (i=0, j=0。 i++, j++){ ... // program code }若函數(shù)的參數(shù)較長，則要進行適當?shù)膭澐忠恍兄粚懸粭l語句不允許把多個短語句寫在一行中，即一行只寫一條語句示例：如下例子不符合規(guī)范。if (pUserCR == NULL) return。 endif // Wrong! Do not indent endif BackToNormal()。在長語句中，如果需要加的空格非常多，那么應該保持整體清晰，而在局部不加空格。 condition。（地址運算符）等單目操作符前后不加空格。 // ++,與內容之間(8)、”[]”、.前后不加空格。 (c=d))三、注釋注釋量一般情況下，源程序有效注釋量必須在20％以上。代碼與注釋同時修改邊寫代碼邊注釋，修改代碼同時修改相應的注釋，以保證注釋與代碼的一致性。例2：ucRepssnInd = aucSsnData[ucIndex].ucRepssnIndex。 示例：可按如下形式說明枚舉/數(shù)據(jù)/聯(lián)合結構。//code one ments */program code one//code two mentsprogram code two應如下書寫：//code one mentsprogram code one//code two mentsprogram code two1連續(xù)case語句處理時，必須編寫注釋對于switch語句下的case語句，如果因為特殊情況需要處理完一個case后進入下一個case處理，必須在該case語句處理完、下一個case語句前加上明確的注釋。}else{ProcessCFW_B()。 break。if (...){ // program code while (index MAX_INDEX) { // program code } /* end of while (index MAX_INDEX) */ //指明該條while語句結束} /* end of if (...)*/ // 指明是哪條if語句結束1注釋格式語句、變量定義、宏定義注釋使用“//……”格式語句塊、函數(shù)說明使用“/* …… */”格式。 (a amp。 a amp。涉及物理狀態(tài)或者含有物理意義的常量，不應直接使用數(shù)字，必須用有意義的枚舉或宏來代替。 = 5。示例：如下表達式，考慮不周就可能出問題，也較難理解。*stat_poi += 1。RELATION System_Init Input_Rec Print_Rec Stat_ScoreStudent Create Modify Access AccessScore Create Modify Access Access, Modify注：RELATION為操作關系；System_Init、Input_Rec、Print_Rec、Stat_Score為四個不同的函數(shù)；Student、Score為兩個全局變量；Create表示創(chuàng)建，Modify表示修改，Access表示訪問。局部變量、嚴禁使用未經(jīng)初始化的變量作為右值說明：特別是在C/C++中引用未經(jīng)賦值的指針，經(jīng)常會引起系統(tǒng)崩潰。帶有“記憶”功能的函數(shù)，其行為可能是不可預測的，因為它的行為可能取決于某種“記憶狀態(tài)”。typedef struct STUDENT_STRU{ unsigned char aucName[8]。 // the student teacher39。typedef struct STUDENT_STRU{ unsigned char aucName[8]。 // his teacher index } STUDENT。} PERSON_ONE。 unsigned char ucSex。typedef struct PERSON_BASE_INFO_STRU{ unsigned char ucName[8]。typedef struct PERSON_STRU{ PERSON_BASE_INFO stPersonBase。 unsigned int uiSetFlg: 1。說明：軟件向前兼容的特性，是軟件產(chǎn)品是否成功的重要標志之