單片機(jī)的C語(yǔ)言基本編程規(guī)范詳細(xì)說明

　　為了提高源程序的質(zhì)量和可維護(hù)性，從而最終提高軟件產(chǎn)品生產(chǎn)力，特編寫此規(guī)范。本標(biāo)準(zhǔn)規(guī)定了程序設(shè)計(jì)人員進(jìn)行程序設(shè)計(jì)時(shí)必須遵循的規(guī)范。本規(guī)范主要針對(duì)單片機(jī)編程語(yǔ)言和08編譯器而言，包括排版、注釋、命名、變量使用、代碼可測(cè)性、程序效率、質(zhì)量保證等內(nèi)容。

　　1．基本規(guī)則

　　格式清晰、注釋簡(jiǎn)明扼要、命名規(guī)范易懂、函數(shù)模塊化、程序易讀易維護(hù)、功能準(zhǔn)確實(shí)現(xiàn)、代碼空間效率和時(shí)間效率高、適度的可擴(kuò)展性、單片機(jī)編程規(guī)范－標(biāo)識(shí)符命名。

　　2．標(biāo)識(shí)符命名

　　2.1 命名基本原則

　　（1）命名清晰明了，有明確含義，使用完整單詞或約定俗成的縮寫。通常，較短的單詞可通過去掉元音字母形成縮寫；較長(zhǎng)的單詞可取單詞的頭幾個(gè)字母形成縮寫。即“見名知意”。

　　（2）命名風(fēng)格要自始至終保持一致。

　?。?）命名中若使用特殊約定或縮寫，要有注釋說明。

　?。?）同一軟件產(chǎn)品內(nèi)模塊之間接口部分的標(biāo)識(shí)符名稱之前加上模塊標(biāo)識(shí)。

　　2.2 宏和常量命名

　　宏和常量用全部大寫字母來(lái)命名，詞與詞之間用下劃線分隔。對(duì)程序中用到的數(shù)字均應(yīng)用有意義的枚舉或宏來(lái)代替。

　　2.3 變量命名

　　變量名用小寫字母命名，每個(gè)詞的第一個(gè)字母大寫。類型前綴（u8\s8 etc.）全局變量另加前綴g_。

　　局部變量應(yīng)簡(jiǎn)明扼要。局部循環(huán)體控制變量?jī)?yōu)先使用i、j、k等；局部長(zhǎng)度變量?jī)?yōu)先使用len、num等；臨時(shí)中間變量?jī)?yōu)先使用temp、tmp等。

　　2.4 函數(shù)命名

　　函數(shù)名用小寫字母命名，每個(gè)詞的第一個(gè)字母大寫，并將模塊標(biāo)識(shí)加在最前面。

　　2.5 文件命名

　　一個(gè)文件包含一類功能或一個(gè)模塊的所有函數(shù)，文件名稱應(yīng)清楚表明其功能或性質(zhì)。每個(gè).c文件應(yīng)該有一個(gè)同名的.h文件作為頭文件。