單片機c51編程規(guī)范(編輯修改稿)
2025-10-22 18:03 本頁面
【文章內容簡介】 *****************************/ 代碼注釋 代碼注釋應與被注釋的代碼緊鄰，放在其上方或右方，不可放在下面。如放于上方則需與其上面的代碼用空行隔開。一般少量注釋應該添加在被注釋語句的行尾，一個函數內的多個注釋左對齊；較多注釋則應加在上方且注釋行與被注釋的語句左對齊。 函數代碼注釋用//…//的格式。 通常，分支語句（條件分支、循環(huán)語句等）必須編寫注釋。其程序塊結束行｝的右方應加表明該程序塊結束的標記end of ……, 尤其在多重嵌套時。 變量、常量、宏的注釋 同一類型的標識符應集中定義，并在定義之前一行對其共性加以統一注釋。對單個標識符的注釋加在定義語句的行尾。 全局變量一定要有詳細的注釋，包括其功能、取值范圍、哪些函數或過程存取它以及存取時的注意事項等。 注釋用//…//的格式。 7 單片機C51編程規(guī)范－函數 設計原則 函數的基本要求： l 正確性：程序要實現設計要求的功能。 l 穩(wěn)定性和安全性：程序運行穩(wěn)定、可靠、安全。 l 可測試性：程序便于測試和評價。 l 規(guī)范／可讀性：程序書寫風格、命名規(guī)則等符合規(guī)范。 l 擴展性：代碼為下一次升級擴展留有空間和接口。 l 全局效率：軟件系統的整體效率高。 l 局部效率：某個模塊／子模塊/函數的本身效率高。 編制函數的基本原則： l 單個函數的規(guī)模盡量限制在200行以內（不包括注釋和空行）。一個函數只完成一個功能。 l 函數局部變量的數目一般不超過5～10個。 l 函數內部局部變量定義區(qū)和功能實現區(qū)（包含變量初始化）之間空一行。 l 函數名應準確描述函數的功能。通常使用動賓詞組為執(zhí)行某操作的函數命名。 l 函數的返回值要清楚明了，尤其是出錯返回值的意義要準確無誤。 l 不要把與函數返回值類型不同的變量，以編譯系統默認的轉換方式或強制的轉換方式作為返回值返回。 l 減少函數本身或函數間的遞歸調用。 l 盡量不要將函數的參數作為工作變量。 函數定義 l 函數若沒有入口參數或者出口參數，應用void明確申明。 l 函數名稱與出口參數類型定義間應該空一格且只空一格。 l 函數名稱與括號()之間無空格。 l 函數形參必須給出明確的類型定義。 l 多個形參的函數，后一個形參與前一個形參的逗號分割符之間添加一個空
環(huán)評公示相關推薦
鄂ICP備17016276號-1