【正文】 st pucSecond。uiTemp。 uchar *pucFirst, *pucSecond。 正確用法示例 uint *puiPoint。、應(yīng)禁止 signed 類(lèi)型與 unsigned 類(lèi)型之間的隱式轉(zhuǎn)化從有符號(hào)類(lèi)型轉(zhuǎn)換為無(wú)符號(hào)類(lèi)型會(huì)導(dǎo)致符號(hào)的丟失。下面的聲明可使數(shù)據(jù)類(lèi)型的使用簡(jiǎn)潔、明了。unsigned short int exam。示例：如下結(jié)構(gòu)中的位域排列，將占較大空間，可讀性也稍差。、結(jié)構(gòu)中元素的個(gè)數(shù)應(yīng)適中若結(jié)構(gòu)中元素個(gè)數(shù)過(guò)多可考慮依據(jù)某種原則把元素組成不同的子結(jié)構(gòu)，以減少原結(jié)構(gòu)中元素的個(gè)數(shù)。 unsigned char aucAddr[40]。 // teacher name unisgned char ucSex。 正確用法：int16_t y[3][2] = { { 1, 2 }, { 3, 4 }, { 5結(jié)構(gòu)、聯(lián)合、結(jié)構(gòu)的功能要單一，是針對(duì)一種事務(wù)的抽象說(shuō)明：設(shè)計(jì)結(jié)構(gòu)時(shí)應(yīng)力爭(zhēng)使結(jié)構(gòu)代表一種現(xiàn)實(shí)事務(wù)的抽象，而不是同時(shí)代表多種。說(shuō)明：若使用了較好的命名規(guī)則，那么此問(wèn)題可自動(dòng)消除。stat_poi++。示例：以下代碼布局不太合理。 ca | b c amp。//if receive_flag is TRUE if (receive_flag)而如下的注釋則給出了額外有用的信息。 break。變量、常量、宏的注釋?xiě)?yīng)放在其上方相鄰位置或右方。參數(shù)：如果參數(shù)值為已知，可以在此詳細(xì)列表說(shuō)明。mem。(4)、‘,’之后要留空格，例如：Function(x, y, z)。if NOTIFY NotifyClient()。 (i usFirstWordLength) amp。amp。amp。　　　　 // 變量x 與 X 容易混淆　　void TMP_foo(uint uiX)。盡量采用英文命名，不可以用漢語(yǔ)拼音。創(chuàng)建信息：創(chuàng)建者名稱，創(chuàng)建日期，最初版本號(hào)，文檔內(nèi)容描述。軟件設(shè)計(jì)規(guī)范制定： 審核： 批準(zhǔn)： 文件編號(hào)生效日期版本號(hào)分發(fā)部門(mén) 修 訂 履 歷序號(hào) 版本修訂內(nèi)容 修訂人修訂日期會(huì)簽與文件發(fā)放：會(huì)簽部門(mén) 會(huì)簽人會(huì)簽日期簽收部門(mén)簽收人簽收日期 深圳市德卡科技有限公司文件編號(hào)文件版本A1生效日期軟件設(shè)計(jì)規(guī)范發(fā)行類(lèi)別■新增 □修訂發(fā)行部門(mén)研發(fā)中心目 錄第一章、項(xiàng)目模塊劃分 15一、模塊劃分 15二、模塊命名 15第二章、文件格式 15一、c文件格式說(shuō)明： 16文件創(chuàng)建及修改說(shuō)明區(qū) 16頭文件引用區(qū) 16全局變量定義區(qū) 16驅(qū)動(dòng)函數(shù)區(qū) 16應(yīng)用函數(shù)區(qū) 17文件結(jié)束說(shuō)明 17二、h文件格式說(shuō)明 17文件創(chuàng)建及修改說(shuō)明區(qū) 17防重調(diào)用定義 18頭文件引用 18控制接口定義區(qū) 18常量定義區(qū) 19宏調(diào)用定義區(qū) 19類(lèi)型定義區(qū) 19外部引用變量區(qū) 19外部引用函數(shù)區(qū) 20操作流程說(shuō)明區(qū) 201文件結(jié)束說(shuō)明 20第三章、命名規(guī)則 21一、函數(shù)命名規(guī)則 21二、變量命名規(guī)則 21三、宏命名規(guī)則 22四、文件命名規(guī)則 22五、新定義變量類(lèi)型命名規(guī)則 22六、命名注意事項(xiàng)： 22標(biāo)識(shí)符命名基本原則 23命名中若使用特殊約定或縮寫(xiě)，則要有注釋說(shuō)明 23局部循環(huán)變量也必須按照變量命名規(guī)則來(lái)定義 23不要用數(shù)字或較奇怪的字符來(lái)定義標(biāo)識(shí)符 23用正確的反義詞組命名具有互斥意義的變量或相反動(dòng)作的函數(shù)等 23避免使用以下劃線開(kāi)始和結(jié)尾的定義 23程序中不要出現(xiàn)僅靠大小寫(xiě)區(qū)分的相似的標(biāo)識(shí)符 23標(biāo)識(shí)符縮寫(xiě) 24函數(shù)名應(yīng)準(zhǔn)確描述函數(shù)的功能 24避免使用無(wú)意義或含義不清的動(dòng)詞為函數(shù)命名 24第四章、代碼書(shū)寫(xiě)規(guī)范 24一、基本原則 24二、排版 24縮進(jìn)風(fēng)格 24不要使用【TAB】鍵 24空行 24語(yǔ)句長(zhǎng)度要小于80個(gè)字符 25長(zhǎng)語(yǔ)句換行 25長(zhǎng)表達(dá)式換行 26若函數(shù)的參數(shù)較長(zhǎng)，則要進(jìn)行適當(dāng)?shù)膭澐?26一行只寫(xiě)一條語(yǔ)句 26括號(hào){} 27語(yǔ)句縮進(jìn)要求 271分界符 281空格 29三、注釋 30注釋量 30函數(shù)頭部注釋 30代碼與注釋同時(shí)修改 31注釋的內(nèi)容要清楚、明了，含義準(zhǔn)確，防止注釋二義性 31避免在注釋中使用縮寫(xiě)，特別是非常用縮寫(xiě) 31注釋書(shū)寫(xiě)位置 31變量、常量命名不能充分自注釋的，必須加以注釋 32數(shù)據(jù)結(jié)構(gòu)命名不能充分自注釋的，必須加以注釋 32全局變量注釋 32注釋要與說(shuō)描述的內(nèi)容進(jìn)行同樣的縮排 321將注釋與其上面的代碼用空行隔開(kāi) 331連續(xù)case語(yǔ)句處理時(shí)，必須編寫(xiě)注釋 341代碼或表達(dá)式的中間禁止插入注釋 361通過(guò)正確命名使代碼成為自注釋的 361在代碼的功能、意圖層次上進(jìn)行注釋?zhuān)峁┯杏?、額外的信息 361在程序塊的結(jié)束行右方加注釋標(biāo)記，以表明某程序塊的結(jié)束 361注釋格式 371采用中文注釋 371使用 if0和 endif注釋代碼塊 37注釋不能嵌套 37四、代碼可讀性 37使用小括號(hào)明確表達(dá)式的操作順序 37用有意義的枚舉和宏替代數(shù)字 38源程序中關(guān)系較為緊密的代碼應(yīng)盡可能相鄰 39用多行簡(jiǎn)單語(yǔ)句替代復(fù)雜語(yǔ)句 39五、變量，結(jié)構(gòu) 40公共變量 去掉沒(méi)必要的公共變量 仔細(xì)定義并明確公共變量的含義、作用、取值范圍及公共變量間的關(guān)系 明確公共變量與操作此公共變量的函數(shù)或過(guò)程的關(guān)系 要謹(jǐn)慎向公共變量傳遞數(shù)據(jù) 防止局部變量與公共變量同名。修改信息：修改者名稱，修改日期，修改后版本號(hào)，修改內(nèi)容描述。標(biāo)識(shí)符的長(zhǎng)度應(yīng)當(dāng)符合“minlength amp?！　?/ 函數(shù)foo 與FOO容易混淆　　void TMP_FOO(float fX)。 (ucRetCode == 1)){ if (ucStatus == 39。 (ucRetCode == 0)){ *pucErrCode = EPRONTCENTER。amp。endifendif BackToNormal()。(5)、如果‘。 // 地址操作amp。如果函數(shù)有調(diào)用全局變量，也要在此 進(jìn)行詳細(xì)說(shuō)明。 示例：//active statistic task number define MAX_ACT_TASK_NUMBER 1000define MAX_ACT_TASK_NUMBER 1000 //active statistic task number數(shù)據(jù)結(jié)構(gòu)命名不能充分自注釋的，必須加以注釋數(shù)據(jù)結(jié)構(gòu)聲明(包括數(shù)組、結(jié)構(gòu)、類(lèi)、枚舉等)，如果其命名不是充分自注釋的，必須加以注釋。case CMD_FWD: ProcessFwd()。 //if mtp receive a message from links if (receive_flag)1在程序塊的結(jié)束行右方加注釋標(biāo)記，以表明某程序塊的結(jié)束說(shuō)明：當(dāng)代碼段較長(zhǎng)，特別是多重嵌套時(shí)，這樣做可以使代碼更清晰，更便于閱讀。 d由于high 8 | low = ( high 8) | low,a | b amp。 = 10。 // 此二語(yǔ)句功能相當(dāng)于“ * stat_poi ++ += 1。、公共變量?jī)H由模塊或函數(shù)創(chuàng)建和修改，其余模塊和函數(shù)只能訪問(wèn)構(gòu)造僅有一個(gè)模塊或函數(shù)可以修改、創(chuàng)建，而其余有關(guān)模塊或函數(shù)只訪問(wèn)的公共變量，防止多個(gè)不同模塊或函數(shù)都可以修改、創(chuàng)建同一公共變量的現(xiàn)象。結(jié)構(gòu)中的各元素應(yīng)代表同一事務(wù)的不同側(cè)面，而不應(yīng)把描述沒(méi)有關(guān)系或關(guān)系很弱的不同事務(wù)的元素放到同一結(jié)構(gòu)中。 // teacher sex, as follows // 0 FEMALE。 unsigned char ucSex。說(shuō)明：增加結(jié)構(gòu)的可理解性、可操作性和可維護(hù)性。typedef struct EXAMPLE_STRU{ unsigned int uiValid: 1。typedef struct EXAM_BIT_STRU{ /* Intel 68360 */ unsigned int A1: 1。typedef unsigned char BYTE。無(wú)符號(hào)數(shù)轉(zhuǎn)換為有符號(hào)數(shù)，可能得到一個(gè)負(fù)值。 uint auiPointTmp[10]。 uint uiTemp。 return。 pucSecond = aucArray + 2。 puiPoint = puiPoint + 2。指針、不應(yīng)對(duì)指針變量使用強(qiáng)制類(lèi)型轉(zhuǎn)換賦值、不應(yīng)把自動(dòng)類(lèi)型的局部變量的地址賦值給外部指針局部變量的地址賦值給外部或者范圍更大的指針，如果局部變量不是靜態(tài)的，那么這種用法是不安全的。typedef unsigned int DWORD。 /* bit 1 6 */ unsigned int A3: 1。 unsigned int uiSetFlg: 1。typedef struct PERSON_BASE_INFO_STRU{ unsigned char ucName[8]。} PERSON_ONE。typedef struct STUDENT_STRU{ unsigned char aucName[8]。typedef struct STUDENT_STRU{ unsigned char aucName[8]。局部變量、嚴(yán)禁使用未經(jīng)初始化的變量作為右值說(shuō)明：特別是在C/C++中引用未經(jīng)賦值的指針，經(jīng)常會(huì)引起系統(tǒng)崩潰。*stat_poi += 1。 = 5。 a amp。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ō)明使用“/* …… */”格式。}else{ProcessCFW_B()。 示例：可按如下形式說(shuō)明枚舉/數(shù)據(jù)/聯(lián)合結(jié)構(gòu)。代碼與注釋同時(shí)修改邊寫(xiě)代碼邊注釋?zhuān)薷拇a同時(shí)修改相應(yīng)的注釋?zhuān)员ＷC注釋與代碼的一致性。 // ++,與內(nèi)容之間(8)、”[]”、.前后不加空格。 condition。 endif // Wrong! Do not indent endif BackToNormal()。 i++, j++){ ... // program code }若函數(shù)的參數(shù)較長(zhǎng)，則要進(jìn)行適當(dāng)?shù)膭澐忠恍兄粚?xiě)一條語(yǔ)句不允許把多個(gè)短語(yǔ)句寫(xiě)在一行中，即一行只寫(xiě)一條語(yǔ)句示例：如下例子不符合規(guī)范。}語(yǔ)句長(zhǎng)度要小于80個(gè)字符 一行語(yǔ)句以小于80字符為宜，不要寫(xiě)得過(guò)長(zhǎng)。) { *pucErrCode = 0。常用單詞縮寫(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ō)明要具體做什么。 maxinformation”原則。自定義頭文件引用：文件名包含著雙