單片機c51編程規(guī)范-在線瀏覽
2024-11-05 18:03本頁面
【正文】 點數(shù)(64位長度) // 5 單片機C51編程規(guī)范－標識符命名 命名基本原則 l 命名要清晰明了，有明確含義，使用完整單詞或約定俗成的縮寫。即見名知意。 l 命名中若使用特殊約定或縮寫，要有注釋說明。 l 同一軟件產品內模塊之間接口部分的標識符名稱之前加上模塊標識。對程序中用到的數(shù)字均應用有意義的枚舉或宏來代替。類型前綴（u8\s8 etc.）全局變量另加前綴g_。局部循環(huán)體控制變量優(yōu)先使用i、j、k等；局部長度變量優(yōu)先使用len、num等；臨時中間變量優(yōu)先使用temp、tmp等。 文件命名 一個文件包含一類功能或一個模塊的所有函數(shù)，文件名稱應清楚表明其功能或性質。 6 單片機C51編程規(guī)范－注釋 注釋基本原則 l 有助于對程序的閱讀理解，說明程序在做什么，解釋代碼的目的、功能和采用的方法。 l 注釋語言必須準確、易懂、簡潔。 文件注釋 文件注釋必須說明文件名、函數(shù)功能、創(chuàng)建人、創(chuàng)建日期、版本信息等相關信息。所有修改記錄必須保持完整。 注釋文本每行縮進4個空格；每個注釋文本分項名稱應對齊。如有必要還可增加作者、創(chuàng)建日期、修改記錄（備注）等相關項目。其中函數(shù)名稱應簡寫為FunctionName()，不加入、出口參數(shù)等信息。如放于上方則需與其上面的代碼用空行隔開。 函數(shù)代碼注釋用//…//的格式。其程序塊結束行｝的右方應加表明該程序塊結束的標記end of ……, 尤其在多重嵌套時。對單個標識符的注釋加在定義語句的行尾。 注釋用//…//的格式。 l 穩(wěn)定性和安全性：程序運行穩(wěn)定、可靠、安全。 l 規(guī)范／可讀性：程序書寫風格、命名規(guī)則等符合規(guī)范。 l 全局效率：軟件系統(tǒng)的整體效率高。 編制函數(shù)的基本原則： l 單個函數(shù)的規(guī)模盡量限制在200行以內（不包括注釋和空行）。 l 函數(shù)局部變量的數(shù)目一般不超過5～10個。 l 函數(shù)名應準確描述函數(shù)的功能。 l 函數(shù)的返回值要清楚明了，尤其是出錯返回值的意義要準確無誤。 l 減少函數(shù)本身或函數(shù)間的遞歸調用。 函數(shù)定義 l 函數(shù)若沒有入口參數(shù)或者出口參數(shù)，應用void明確申明。 l 函數(shù)名稱與括號()之間無空格。 l 多個形參的函數(shù)，后一個形參與前一個形參的逗號分割符之間添加一個空格。 局部變量定義 l 同一行內不要定義過多變量。
環(huán)評公示相關推薦
鄂ICP備17016276號-1