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

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

　　1．基本規(guī)則

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

　　2．標識符命名

　　2.1 命名基本原則

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

　?。?）命名風格要自始至終保持一致。

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

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

　　2.2 宏和常量命名

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

　　2.3 變量命名

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

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

　　2.4 函數(shù)命名

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

　　2.5 文件命名

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