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

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

　　1．基本規(guī)則

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

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

　　2.1 命名基本原則

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

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

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

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

　　2.2 宏和常量命名

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

　　2.3 變量命名

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

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

　　2.4 函數(shù)命名

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

　　2.5 文件命名

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