單片機(jī)c51編程規(guī)范-文庫吧資料
2024-10-08 18:03本頁面
【正文】 口參數(shù)類型定義間應(yīng)該空一格且只空一格。 l 盡量不要將函數(shù)的參數(shù)作為工作變量。 l 不要把與函數(shù)返回值類型不同的變量，以編譯系統(tǒng)默認(rèn)的轉(zhuǎn)換方式或強(qiáng)制的轉(zhuǎn)換方式作為返回值返回。通常使用動(dòng)賓詞組為執(zhí)行某操作的函數(shù)命名。 l 函數(shù)內(nèi)部局部變量定義區(qū)和功能實(shí)現(xiàn)區(qū)（包含變量初始化）之間空一行。一個(gè)函數(shù)只完成一個(gè)功能。 l 局部效率：某個(gè)模塊／子模塊/函數(shù)的本身效率高。 l 擴(kuò)展性：代碼為下一次升級(jí)擴(kuò)展留有空間和接口。 l 可測(cè)試性：程序便于測(cè)試和評(píng)價(jià)。 7 單片機(jī)C51編程規(guī)范－函數(shù) 設(shè)計(jì)原則 函數(shù)的基本要求： l 正確性：程序要實(shí)現(xiàn)設(shè)計(jì)要求的功能。 全局變量一定要有詳細(xì)的注釋，包括其功能、取值范圍、哪些函數(shù)或過程存取它以及存取時(shí)的注意事項(xiàng)等。 變量、常量、宏的注釋 同一類型的標(biāo)識(shí)符應(yīng)集中定義，并在定義之前一行對(duì)其共性加以統(tǒng)一注釋。 通常，分支語句（條件分支、循環(huán)語句等）必須編寫注釋。一般少量注釋應(yīng)該添加在被注釋語句的行尾，一個(gè)函數(shù)內(nèi)的多個(gè)注釋左對(duì)齊；較多注釋則應(yīng)加在上方且注釋行與被注釋的語句左對(duì)齊。 /*********************************************************** 函數(shù)名稱： 函數(shù)功能： 入口參數(shù)： 出口參數(shù)： 備 注： ***********************************************************/ 代碼注釋 代碼注釋應(yīng)與被注釋的代碼緊鄰，放在其上方或右方，不可放在下面。 函數(shù)頭部注釋放在每個(gè)函數(shù)的頂端，用/*……*/的格式包含。 /*********************************************************** 文件名稱： 作 者： 版 本： 說 明： 修改記錄： ***********************************************************/ 函數(shù)注釋 函數(shù)頭部注釋 函數(shù)頭部注釋應(yīng)包括函數(shù)名稱、函數(shù)功能、入口參數(shù)、出口參數(shù)等內(nèi)容。 文件注釋放在文件頂端，用/*……*/格式包含。 修改文件代碼時(shí)，應(yīng)在文件注釋中記錄修改日期、修改人員，并簡要說明此次修改的目的。 l 邊寫代碼邊注釋，修改代碼同
環(huán)評(píng)公示相關(guān)推薦
鄂ICP備17016276號(hào)-1