單片機(jī)c51編程規(guī)范-全文預(yù)覽
【正文】 于測(cè)試和評(píng)價(jià)。 全局變量一定要有詳細(xì)的注釋，包括其功能、取值范圍、哪些函數(shù)或過(guò)程存取它以及存取時(shí)的注意事項(xiàng)等。 通常，分支語(yǔ)句（條件分支、循環(huán)語(yǔ)句等）必須編寫注釋。 /*********************************************************** 函數(shù)名稱： 函數(shù)功能： 入口參數(shù)： 出口參數(shù)： 備 注： ***********************************************************/ 代碼注釋 代碼注釋應(yīng)與被注釋的代碼緊鄰，放在其上方或右方，不可放在下面。 /*********************************************************** 文件名稱： 作 者： 版 本： 說(shuō) 明： 修改記錄： ***********************************************************/ 函數(shù)注釋 函數(shù)頭部注釋 函數(shù)頭部注釋應(yīng)包括函數(shù)名稱、函數(shù)功能、入口參數(shù)、出口參數(shù)等內(nèi)容。 修改文件代碼時(shí)，應(yīng)在文件注釋中記錄修改日期、修改人員，并簡(jiǎn)要說(shuō)明此次修改的目的。 l 一般情況源程序有效注釋量在30％左右。 函數(shù)命名 函數(shù)名用小寫字母命名，每個(gè)詞的第一個(gè)字母大寫，并將模塊標(biāo)識(shí)加在最前面。 變量命名 變量名用小寫字母命名，每個(gè)詞的第一個(gè)字母大寫。 l 除了編譯開關(guān)/頭文件等特殊應(yīng)用，應(yīng)避免使用以下劃線開始和／或結(jié)尾的定義。通常，較短的單詞可通過(guò)去掉元音字母形成縮寫；較長(zhǎng)的單詞可取單詞的頭幾個(gè)字母形成縮寫。 // 無(wú)符號(hào)32位整型變量 // typedef signed long INT32S。 // 無(wú)符號(hào)8位整型變量 // typedef signed char INT8S。本規(guī)范主要針對(duì)C51編程語(yǔ)言和keil編譯器而言，包括排版、注釋、命名、變量使用、代碼可測(cè)性、程序效率、質(zhì)量保證等內(nèi)容。 2 單片機(jī)C51編程規(guī)范－范圍 本標(biāo)準(zhǔn)規(guī)定了程序設(shè)計(jì)人員進(jìn)行程序設(shè)計(jì)時(shí)必須遵循的規(guī)范。 // 位變量 // typedef unsigned char INT8U。 // 有符號(hào)16位整型變量 // typedef unsigned long
環(huán)評(píng)公示相關(guān)推薦
鄂ICP備17016276號(hào)-1