【正文】 ch語句下的case語句，如果因?yàn)樘厥馇闆r需要處理完一個(gè) case后進(jìn)入下一個(gè)case 處理，必須在該 case語句處理完、下一個(gè)case語句前加上明確的注釋。示例（注意斜體加粗部分）：case CMD_UP: ProcessUp()。case CMD_DOWN: ProcessDown()。case CMD_FWD: ProcessFwd()。 /* now jump into case CMD_A */case CMD_A: ProcessA()。case CMD_B: ProcessB()。default: break。[必須]說明：除非必要（如 PCLINT 的行禁止檢查標(biāo)記），不應(yīng)在代碼或表達(dá)中間插入注釋，否則容易使代碼可理解性變差。[建議]說明：清晰準(zhǔn)確的函數(shù)、變量等的命名，可增加代碼可讀性，并減少不必要的注釋。[建議]說明：注釋的目的是解釋代碼的目的、功能和采用的方法，提供代碼以外的信息，幫助讀者理解代碼，防止沒必要的重復(fù)注釋信息。/* if receive_flag is TRUE */if (receive_flag)而如下的注釋則給出了額外有用的信息。[可選]說明：當(dāng)代碼段較長(zhǎng)，特別是多重嵌套時(shí)，這樣做可以使代碼更清晰，更便于閱讀。示例：參見如下例子。 [建議]TRZN項(xiàng)目： Embedded software development領(lǐng)域： SW Engineering文件名稱： 嵌入式軟件編程規(guī)范文件號(hào): SW00000001版本號(hào): 日期: 20221028所屬部門: 電控質(zhì)量管理部?jī)H限項(xiàng)目組內(nèi)部傳閱 Page 19 of 47 4 標(biāo)識(shí)符命名? 【規(guī)則 41】標(biāo)識(shí)符的命名要清晰、明了，有明確含義，同時(shí)使用完整的單詞或大家基本可以理解的縮寫，避免使人產(chǎn)生誤解。示例：如下單詞的縮寫能夠被大家基本認(rèn)可。flag 可縮寫為 flg。increment 可縮寫為 inc。message 可縮寫為 msg。receive 可縮寫為 rec。[必須]說明：應(yīng)該在源文件的開始之處，對(duì)文件中所使用的縮寫或約定，特別是特殊的縮寫，進(jìn)行必要的注釋說明。[建議]說明：個(gè)人的命名風(fēng)格，在符合所在項(xiàng)目組或產(chǎn)品組的命名規(guī)則的前提下，才可使用。? 【規(guī)則 44】常量的定義全部采用大寫單詞，單詞中間以下劃線分開，并且各模塊中的常量第一個(gè)單詞必須為模塊頭，定義的常數(shù)必須加括號(hào)。[必須]TRZN項(xiàng)目： Embedded software development領(lǐng)域： SW Engineering文件名稱： 嵌入式軟件編程規(guī)范文件號(hào): SW00000001版本號(hào): 日期: 20221028所屬部門: 電控質(zhì)量管理部?jī)H限項(xiàng)目組內(nèi)部傳閱 Page 20 of 47 說明：示例：typedef struct RVP_MSG_HDR_t{ UINT32 version:4。 UINT32 msgLen。typedef struct RVP_RESV_MSG_t{ RVP_MSG_HDR_T msgHdr。 UINT8 ucSvcCode。 UINT32 unSvcData1。 UINT32 unSvcData3。? 【規(guī)則 46】枚舉類型的命名必須全部為大寫字母，第1個(gè)單詞為模塊名，最后一個(gè)單詞為 _T，單詞之間以下劃線分開。? 【規(guī)則 47】對(duì)于變量命名，禁止取單個(gè)字符（如i、j、k...），建議除了要有具體含義外，還能表明其變量類型、數(shù)據(jù)類型等，但i、j、k作局部循環(huán)變量是允許的。[必須]例如：UINT32 dccResetAddr。TRZN項(xiàng)目： Embedded software development領(lǐng)域： SW Engineering文件名稱： 嵌入式軟件編程規(guī)范文件號(hào): SW00000001版本號(hào): 日期: 20221028所屬部門: 電控質(zhì)量管理部?jī)H限項(xiàng)目組內(nèi)部傳閱 Page 21 of 47 ? 【規(guī)則 49】全局變量的頭部必須有“g+subsystem”的標(biāo)記，用于區(qū)分全局變量的模塊范圍，同時(shí)防止重名。[必須]例如：UINT8 gFmaVariableName。 【規(guī)則 4101 】模塊的全局變量必須組織在同一個(gè)結(jié)構(gòu)體中進(jìn)行管理。 MIBpbRstpPortTable_t stp_gPortCfg[HII_MAX_PORT_NUM]。 stp_PortData_s stp_gPortInfo[HII_MAX_PORT_NUM]。 stp_BPDU_s stp_gRcvdBPDU[HII_MAX_PORT_NUM]。 }STP_S_STPInfo_T。 ? 【規(guī)則 411】 變量的前綴表示方法[必須]類型 描述 前綴 舉例* 指針 p UINT8 *pucIndex。BOOL 布爾值 b BOOL bMonitored。UINT8 8bit 無符號(hào)整數(shù) uc (optional) UINT8 ucIndex。UINT16 16bit 無符號(hào)整數(shù) us (optional) UINT16 usPort。UINT32 32bit 無符號(hào)整數(shù) ul (optional) UINT32 ulErrorCode。int 依賴于操作系統(tǒng)的不定長(zhǎng)整數(shù)(不建議使用)n (optnional) int nIndex。UINT 依賴于操作系統(tǒng)的不定長(zhǎng)無符號(hào)整數(shù)(不建議使用)u (optional)Enum 枚舉 e (optional)(other) 其他復(fù)雜類型(如結(jié)構(gòu)) 按慣例或自行定義(注意全局一致)MSG_Q_ID msgQPmon。? 【規(guī)則 412】通用類型定義的使用：盡可能使用CTD(Common Type Definitions)中定義的數(shù)值類型，盡量少定義自己的數(shù)據(jù)類型(在不影響程序可讀性的前提下)。示例：如下命名，使人產(chǎn)生疑惑。應(yīng)改為有意義的單詞命名:define _RPR_EXAMPLE_UNIT_TEST_define _RPR_EXAMPLE_ASSERT_TEST_void RPR_setUdtMsgSls(UINT8 ucSls )。不得把意義相反的單詞合并在一個(gè)變量名或函數(shù)名中，以免意義不清。add / remove begin / end create / destroy insert / delete first / last get / releaseincrement / decrement put / getadd / delete lock / unlock open / closemin / max old / new start / stopnext / previous source / target show / hidesend / receive source / destinationTRZN項(xiàng)目： Embedded software development領(lǐng)域： SW Engineering文件名稱： 嵌入式軟件編程規(guī)范文件號(hào): SW00000001版本號(hào): 日期: 20221028所屬部門: 電控質(zhì)量管理部?jī)H限項(xiàng)目組內(nèi)部傳閱 Page 23 of 47 cut / paste up / down示例：int minSum。int addUser( UINT8 *userName )。錯(cuò)誤：int addOrDelUser(UINT8 *userName)。[必須]項(xiàng)目目錄樹模板：SOURCE_ROOT include …… | +infra | | | +ZZZ | …… +appl | | +XXXinc (exported functions and definitions) | | | src (source code and private header files) | | | doc (documents, test plans) |YYYinc | | | src | | | doc ..... . .其中 ZZZ、XXX、YYY 為模塊名? 【規(guī)則 416】模塊的外部接口定義應(yīng)當(dāng)放在”XXX/inc”目錄下；建議把所有接口放在一個(gè)文件中，此時(shí)一般可命名為””。不得把內(nèi)部接口與外部接口放在同一個(gè)頭文件中。只有外部接口才是。? 【規(guī)則 418】模塊的屬主(owner):每個(gè)模塊都有一個(gè)唯一的屬主。【規(guī)則 4181】模塊的屬主對(duì)此模塊負(fù)責(zé)，只有他可以對(duì)此模塊進(jìn)行修改。? 【規(guī)則 419】在使用SVS時(shí)，模塊的正式完整列表維護(hù)在CVS的根目錄下，文本文件””中。這個(gè)文件一般由項(xiàng)目負(fù)責(zé)人來維護(hù)。 文件類型 C H C++ Java Assembler HTML擴(kuò)展名 *.c *.h *.cpp *.java *.s *.htmlTable 41 文件擴(kuò)展名與文件類型TRZN項(xiàng)目： Embedded software development領(lǐng)域： SW Engineering文件名稱： 嵌入式軟件編程規(guī)范文件號(hào): SW00000001版本號(hào): 日期: 20221028所屬部門: 電控質(zhì)量管理部?jī)H限項(xiàng)目組內(nèi)部傳閱 Page 25 of 47 5 可讀性? 【規(guī)則 51】注意運(yùn)算符的優(yōu)先級(jí)，并用括號(hào)明確表達(dá)式的操作順序，避免使用默認(rèn)優(yōu)先級(jí)。示例：下列語句中的表達(dá)式word = (high 8) | low (1)if ((a | b) amp。 (a amp。 d)) (3)如果書寫為high 8 | lowa | b amp。 a amp。 d由于high 8 | low = ( high 8) | low,a | b amp。 a amp。amp。 c)，(1)(2)不會(huì)出錯(cuò)，但語句不易理解；a | b c amp。 d，