單片機(jī)c51編程規(guī)范-免費(fèi)閱讀
【正文】 可重入函數(shù) 可重入函數(shù)中若使用了全局變量，應(yīng)通過關(guān)中斷、信號量等操作手段對其加以保護(hù)。 Switch ( ) { case x: break。共同占用一行。 l 函數(shù)形參之間應(yīng)該有且只有一個空格（形參逗號后面加空格）。避免把注釋插入分行中。 l 各程序段之間使用一個空行分隔，加以必要的注釋。 l 多個形參的函數(shù)，后一個形參與前一個形參的逗號分割符之間添加一個空格。 l 函數(shù)的返回值要清楚明了，尤其是出錯返回值的意義要準(zhǔn)確無誤。 l 全局效率：軟件系統(tǒng)的整體效率高。對單個標(biāo)識符的注釋加在定義語句的行尾。其中函數(shù)名稱應(yīng)簡寫為FunctionName()，不加入、出口參數(shù)等信息。 文件注釋 文件注釋必須說明文件名、函數(shù)功能、創(chuàng)建人、創(chuàng)建日期、版本信息等相關(guān)信息。局部循環(huán)體控制變量優(yōu)先使用i、j、k等；局部長度變量優(yōu)先使用len、num等；臨時中間變量優(yōu)先使用temp、tmp等。 l 命名中若使用特殊約定或縮寫，要有注釋說明。 // 有符號16位整型變量 // typedef unsigned long INT32U。 2 單片機(jī)C51編程規(guī)范－范圍 本標(biāo)準(zhǔn)規(guī)定了程序設(shè)計人員進(jìn)行程序設(shè)計時必須遵循的規(guī)范。 // 無符號8位整型變量 // typedef signed char INT8S。通常，較短的單詞可通過去掉元音字母形成縮寫；較長的單詞可取單詞的頭幾個字母形成縮寫。 變量命名 變量名用小寫字母命名，每個詞的第一個字母大寫。 l 一般情況源程序有效注釋量在30％左右。 /*********************************************************** 文件名稱： 作 者： 版 本： 說 明： 修改記錄： ***********************************************************/ 函數(shù)注釋 函數(shù)頭部注釋 函數(shù)頭部注釋應(yīng)包括函數(shù)名稱、函數(shù)功能、入口參數(shù)、出口參數(shù)等內(nèi)容。 通常，分支語句（條件分支、循環(huán)語句等）必須編寫注釋。 l 可測試性：程序便于測試和評價。 l 函數(shù)內(nèi)部局部變量定義區(qū)和功能實(shí)現(xiàn)區(qū)（包含變量初始化）之間空一行。 l 函數(shù)名稱與出口參數(shù)類型定義間應(yīng)該空一格且只空一格。
環(huán)評公示相關(guān)推薦
鄂ICP備17016276號-1