c源程序編碼規(guī)范(doc)-流程管理-在線(xiàn)瀏覽
2024-10-21 09:05本頁(yè)面
【正文】 中國(guó)最大的管 理 資料下載中心 (收集 \整理 . 大量免費(fèi)資源共享 ) 第 2 頁(yè) 共 7 頁(yè) 21：一般情況下，源程序有效注釋量必須在 20％以上。 23：源文件頭部應(yīng)進(jìn)行注釋?zhuān)谐觯喊鏅?quán)說(shuō)明、版本號(hào)、生成日期、作者、模塊目的 /功能、主要函數(shù)及其功能、修改日志等。 25：邊寫(xiě)代碼邊注釋?zhuān)薷拇a同時(shí)修改相應(yīng)的注釋?zhuān)员ＷC注釋與代碼的一致性。 26：注釋的內(nèi)容要清楚、明了，含義準(zhǔn)確，防止注釋二義性。 28：注釋?xiě)?yīng)與其描述的代碼相近，對(duì)代碼的注釋?xiě)?yīng)放在其上方或右方（對(duì)單條語(yǔ)句的注釋?zhuān)┫噜徫恢茫豢煞旁谙旅?，如放于上方則需與其上面的代碼用空行隔開(kāi)。變量、常量、宏的注釋?xiě)?yīng)放在其上方相鄰位置或右方。對(duì)數(shù)據(jù)結(jié)構(gòu)的注釋?xiě)?yīng)放在其上方相鄰位置，不可放在下面 ；對(duì)結(jié)構(gòu)中的每個(gè)域的注釋放在此域的右方。 212：注釋與所描述內(nèi)容進(jìn)行同樣的縮排。 214：對(duì)變量的定義和分支語(yǔ)句（條件分支、循環(huán)語(yǔ)句等）必須編寫(xiě)注釋。 標(biāo) 識(shí)符命名 31：標(biāo)識(shí)符的命名要清晰、明了，有明確含義，同時(shí)使用完整的單詞或大家基本可以理解的縮寫(xiě)，避免使人產(chǎn)生誤解。 33：自己特有的命名風(fēng)格，要自始至終保持一致，不可來(lái)回變化。 35：命名規(guī)范必須與所使用的系統(tǒng)風(fēng)格保持一致，并在同一項(xiàng)目中統(tǒng)一，比如采用UNIX的全小寫(xiě)加下劃線(xiàn)的風(fēng)格或大 小寫(xiě)混排的方式，不要使用大小寫(xiě)與下劃線(xiàn)混排的方式。 42：避免使用不易理解的數(shù)字，用有意義的標(biāo)識(shí)來(lái)替代。 變量 51：去掉沒(méi)必要的公共變量。 53：明確公共變量與操作此公共變量的函數(shù)或過(guò)程的關(guān)系，如訪(fǎng)問(wèn)、修改及創(chuàng)建等。 中國(guó)最大的管 理 資料下載中心 (收集 \整理 . 大量免費(fèi)資源共享 ) 第 4 頁(yè) 共 7 頁(yè) 55：防止局部變量與公共變量同名。 函數(shù)、過(guò)程 61：對(duì)所調(diào)用函數(shù)的錯(cuò)誤返回碼要仔細(xì)、全面地處理。 63：編寫(xiě)可重入函數(shù)時(shí)，應(yīng)注意局部變量的使用 (如編寫(xiě) C/C++語(yǔ)言的可重入函數(shù)時(shí)，應(yīng)使用
環(huán)評(píng)公示相關(guān)推薦
鄂ICP備17016276號(hào)-1