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