久久久久久久999_99精品久久精品一区二区爱城_成人欧美一区二区三区在线播放_国产精品日本一区二区不卡视频_国产午夜视频_欧美精品在线观看免费

標(biāo)題: 單片機(jī)C51編程規(guī)范 [打印本頁(yè)]

作者: 34770064    時(shí)間: 2016-1-13 14:37
標(biāo)題: 單片機(jī)C51編程規(guī)范
在網(wǎng)上找到這份單片機(jī)C51編程規(guī)范,覺(jué)得很有用,決定在以后自己編C51程序的時(shí)候用上。
1單片機(jī)C51編程規(guī)范-前言
為了提高源程序的質(zhì)量和可維護(hù)性,從而最終提高軟件產(chǎn)品生產(chǎn)力,特編寫(xiě)此規(guī)范。
2單片機(jī)C51編程規(guī)范-范圍本標(biāo)準(zhǔn)規(guī)定了程序設(shè)計(jì)人員進(jìn)行程序設(shè)計(jì)時(shí)必須遵循的規(guī)范。本規(guī)范主要針對(duì)C51編程語(yǔ)言和keil編譯器而言,包括排版、注釋、命名、變量使用、代碼可測(cè)性、程序效率、質(zhì)量保證等內(nèi)容。

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

4單片機(jī)C51編程規(guī)范-數(shù)據(jù)類(lèi)型定義
編程時(shí)統(tǒng)一采用下述新類(lèi)型名的方式定義數(shù)據(jù)類(lèi)型。
建立一個(gè)datatype.h文件,在該文件中進(jìn)行如下定義:
typedefbitbool;//位變量//
typedef unsigned charuint8;//無(wú)符號(hào)8位整型變量//
typedefsignedcharint8;//有符號(hào)8位整型變量//
typedef unsignedintuint16;//無(wú)符號(hào)16位整型變量//
typedef signedintint16;//有符號(hào)16位整型變量//
typedef unsigned longuint32;//無(wú)符號(hào)32位整型變量//
typedef signedlongint32;//有符號(hào)32位整型變量//
typedeffloatfp32;//單精度浮點(diǎn)數(shù)(32位長(zhǎng)度) //
typedefdoublefp64;//雙精度浮點(diǎn)數(shù)(64位長(zhǎng)度) //


5單片機(jī)C51編程規(guī)范-標(biāo)識(shí)符命名
5.1命名基本原則
命名要清晰明了,有明確含義,使用完整單詞或約定俗成的縮寫(xiě)。通常,較短的單詞可通過(guò)去掉元音字母形成縮寫(xiě);較長(zhǎng)的單詞可取單詞的頭幾個(gè)字母形成縮寫(xiě)。即"見(jiàn)名知意"。
命名風(fēng)格要自始至終保持一致。
命名中若使用特殊約定或縮寫(xiě),要有注釋說(shuō)明。
除了編譯開(kāi)關(guān)/頭文件等特殊應(yīng)用,應(yīng)避免使用以下劃線開(kāi)始和/或結(jié)尾的定義。
同一軟件產(chǎn)品內(nèi)模塊之間接口部分的標(biāo)識(shí)符名稱(chēng)之前加上模塊標(biāo)識(shí)。

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

5.3變量命名
變量名用小寫(xiě)字母命名,每個(gè)詞的第一個(gè)字母大寫(xiě)。類(lèi)型前綴(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等。

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

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

6單片機(jī)C51編程規(guī)范-注釋
6.1注釋基本原則
有助于對(duì)程序的閱讀理解,說(shuō)明程序在"做什么",解釋代碼的目的、功能和采用的方法。
一般情況源程序有效注釋量在30%左右。
注釋語(yǔ)言必須準(zhǔn)確、易懂、簡(jiǎn)潔。
邊寫(xiě)代碼邊注釋?zhuān)薷拇a同時(shí)修改相應(yīng)的注釋?zhuān)辉儆杏玫淖⑨屢獎(jiǎng)h除。

6.2文件注釋
文件注釋必須說(shuō)明文件名、函數(shù)功能、創(chuàng)建人、創(chuàng)建日期、版本信息等相關(guān)信息。
修改文件代碼時(shí),應(yīng)在文件注釋中記錄修改日期、修改人員,并簡(jiǎn)要說(shuō)明此次修改的目的。所有修改記錄必須保持完整。
文件注釋放在文件頂端,用""格式包含。
注釋文本每行縮進(jìn)4個(gè)空格;每個(gè)注釋文本分項(xiàng)名稱(chēng)應(yīng)對(duì)齊。


6.3函數(shù)注釋
6.3.1函數(shù)頭部注釋
函數(shù)頭部注釋?xiě)?yīng)包括函數(shù)名稱(chēng)、函數(shù)功能、入口參數(shù)、出口參數(shù)等內(nèi)容。如有必要還可增加作者、創(chuàng)建日期、修改記錄(備注)等相關(guān)項(xiàng)目。
函數(shù)頭部注釋放在每個(gè)函數(shù)的頂端,用""的格式包含。其中函數(shù)名稱(chēng)應(yīng)簡(jiǎn)寫(xiě)為FunctionName(),不加入、出口參數(shù)等信息。


6.3.2代碼注釋
代碼注釋?xiě)?yīng)與被注釋的代碼緊鄰,放在其上方或右方,不可放在下面。如放于上方則需與其上面的代碼用空行隔開(kāi)。一般少量注釋?xiě)?yīng)該添加在被注釋語(yǔ)句的行尾,一個(gè)函數(shù)內(nèi)的多個(gè)注釋左對(duì)齊;較多注釋則應(yīng)加在上方且注釋行與被注釋的語(yǔ)句左對(duì)齊。
函數(shù)代碼注釋用"//…//"的格式。
通常,分支語(yǔ)句(條件分支、循環(huán)語(yǔ)句等)必須編寫(xiě)注釋。其程序塊結(jié)束行"}"的右方應(yīng)加表明該程序塊結(jié)束的標(biāo)記"end of ……",尤其在多重嵌套時(shí)。

6.4變量、常量、宏的注釋
同一類(lèi)型的標(biāo)識(shí)符應(yīng)集中定義,并在定義之前一行對(duì)其共性加以統(tǒng)一注釋。對(duì)單個(gè)標(biāo)識(shí)符的注釋加在定義語(yǔ)句的行尾。
全局變量一定要有詳細(xì)的注釋?zhuān)ㄆ涔δ、取值范圍、哪些函?shù)或過(guò)程存取它以及存取時(shí)的注意事項(xiàng)等。
注釋用"//…//"的格式。

7單片機(jī)C51編程規(guī)范-函數(shù)
7.1設(shè)計(jì)原則
函數(shù)的基本要求:
正確性:程序要實(shí)現(xiàn)設(shè)計(jì)要求的功能。
穩(wěn)定性和安全性:程序運(yùn)行穩(wěn)定、可靠、安全。
可測(cè)試性:程序便于測(cè)試和評(píng)價(jià)。
規(guī)范/可讀性:程序書(shū)寫(xiě)風(fēng)格、命名規(guī)則等符合規(guī)范。
擴(kuò)展性:代碼為下一次升級(jí)擴(kuò)展留有空間和接口。
全局效率:軟件系統(tǒng)的整體效率高。
局部效率:某個(gè)模塊/子模塊/函數(shù)的本身效率高。

編制函數(shù)的基本原則:
單個(gè)函數(shù)的規(guī)模盡量限制在200行以?xún)?nèi)(不包括注釋和空行)。一個(gè)函數(shù)只完成一個(gè)功能。
函數(shù)局部變量的數(shù)目一般不超過(guò)5~10個(gè)。
函數(shù)內(nèi)部局部變量定義區(qū)和功能實(shí)現(xiàn)區(qū)(包含變量初始化)之間空一行。
函數(shù)名應(yīng)準(zhǔn)確描述函數(shù)的功能。通常使用動(dòng)賓詞組為執(zhí)行某操作的函數(shù)命名。
函數(shù)的返回值要清楚明了,尤其是出錯(cuò)返回值的意義要準(zhǔn)確無(wú)誤。
不要把與函數(shù)返回值類(lèi)型不同的變量,以編譯系統(tǒng)默認(rèn)的轉(zhuǎn)換方式或強(qiáng)制的轉(zhuǎn)換方式作為返回值返回。
減少函數(shù)本身或函數(shù)間的遞歸調(diào)用。
盡量不要將函數(shù)的參數(shù)作為工作變量。

7.2函數(shù)定義
函數(shù)若沒(méi)有入口參數(shù)或者出口參數(shù),應(yīng)用void明確申明。
函數(shù)名稱(chēng)與出口參數(shù)類(lèi)型定義間應(yīng)該空一格且只空一格。
函數(shù)名稱(chēng)與括號(hào)()之間無(wú)空格。
函數(shù)形參必須給出明確的類(lèi)型定義。
多個(gè)形參的函數(shù),后一個(gè)形參與前一個(gè)形參的逗號(hào)分割符之間添加一個(gè)空格。
函數(shù)體的前后花括號(hào)"{}"各獨(dú)占一行。

7.3局部變量定義
同一行內(nèi)不要定義過(guò)多變量。
同一類(lèi)的變量在同一行內(nèi)定義,或者在相鄰行定義。
先定義data型變量,再定義idtata型變量,再定義xdata型變量.
數(shù)組、指針等復(fù)雜類(lèi)型的定義放在定義區(qū)的最后。
變量定義區(qū)不做較復(fù)雜的變量賦值。

7.4功能實(shí)現(xiàn)區(qū)規(guī)范
l一行只寫(xiě)一條語(yǔ)句。
l注意運(yùn)算符的優(yōu)先級(jí),并用括號(hào)明確表達(dá)式的操作順序,避免使用默認(rèn)優(yōu)先級(jí)。
各程序段之間使用一個(gè)空行分隔,加以必要的注釋。程序段指能完一個(gè)較具體的功能的一行或多行代碼。程序段內(nèi)的各行代碼之間相互依賴(lài)性較強(qiáng)。
不要使用難懂的技巧性很高的語(yǔ)句。
源程序中關(guān)系較為緊密的代碼應(yīng)盡可能相鄰。
完成簡(jiǎn)單功能、關(guān)系非常密切的一條或幾條語(yǔ)句可編寫(xiě)為函數(shù)或定義為宏。

8單片機(jī)C51編程規(guī)范-排版
8.1縮進(jìn)
代碼的每一級(jí)均往右縮進(jìn)4個(gè)空格的位置。

8.2分行
過(guò)長(zhǎng)的語(yǔ)句(超過(guò)80個(gè)字符)要分成多行書(shū)寫(xiě);長(zhǎng)表達(dá)式要在低優(yōu)先級(jí)操作符處劃分新行,操作符放在新行之首,劃分出的新行要進(jìn)適當(dāng)?shù)目s進(jìn),使排版整齊,語(yǔ)句可讀。避免把注釋插入分行中。

8.3空行
文件注釋區(qū)、頭文件引用區(qū)、函數(shù)間應(yīng)該有且只有一行空行。
相鄰函數(shù)之間應(yīng)該有且只有一行空行。
函數(shù)體內(nèi)相對(duì)獨(dú)立的程序塊之間可以用一行空行或注釋來(lái)分隔。
函數(shù)注釋和對(duì)應(yīng)的函數(shù)體之間不應(yīng)該有空行。
文件末尾有且只有一行空行。

8.4空格
函數(shù)語(yǔ)句尾部或者注釋之后不能有空格。
括號(hào)內(nèi)側(cè)(即左括號(hào)后面和右括號(hào)前面)不加空格,多重括號(hào)間不加空格。
函數(shù)形參之間應(yīng)該有且只有一個(gè)空格(形參逗號(hào)后面加空格)。
同一行中定義的多個(gè)變量間應(yīng)該有且只有一個(gè)空格(變量逗號(hào)后面加空格)。
表達(dá)式中,若有多個(gè)操作符連寫(xiě)的情況,應(yīng)使用空格對(duì)它們分隔:
在兩個(gè)以上的關(guān)鍵字、變量、常量進(jìn)行對(duì)等操作時(shí),它們之間的操作符前后均加一個(gè)空格;在兩個(gè)以上的關(guān)鍵字、變量、常量進(jìn)行非對(duì)等操作時(shí),其前后均不應(yīng)加空格;
逗號(hào)只在后面加空格;
雙目操作符,如比較操作符,賦值操作符"="、"+=",算術(shù)操作符"+"、"%",邏輯操作符"&&"、"&",位操作符"<<"、"^"等,前后均加一個(gè)空格;
單目操作符,如"!"、"~"、"++"、"-"、"&"(地址運(yùn)算符)等,前后不加空格;
"->"、"."前后不加空格;
if、for、while、switch等關(guān)鍵字與后面的括號(hào)間加一個(gè)空格;

8.5花括號(hào)
l if、else if、else、for、while語(yǔ)句無(wú)論其執(zhí)行體是一條語(yǔ)句還是多條語(yǔ)句都必須加花括號(hào),且左右花括號(hào)各獨(dú)占一行。
l do{}while()結(jié)構(gòu)中,"do"和"{"均各占一行,"}"和"while();"共同占用一行。
if ( ) do
{
}while( );
else
{

}

8.6 switch語(yǔ)句
l每個(gè)case和其判據(jù)條件獨(dú)占一行。
l每個(gè)case程序塊需用break結(jié)束。特殊情況下需要從一個(gè)case塊順序執(zhí)行到下一個(gè)case塊的時(shí)候除外,但需要在交界處明確注釋如此操作的原因,以防止出錯(cuò)。
l case程序塊之間空一行,且只空一行。
l每個(gè)case程序塊的執(zhí)行語(yǔ)句保持4個(gè)空格的縮進(jìn)。
l一般情況下都應(yīng)該包含default分支。
Switch ( )
{
case x:

break;

case x:

break;

default:

break;
}

9單片機(jī)C51編程規(guī)范-程序結(jié)構(gòu)
9.1基本要求
有main()函數(shù)的.c文件應(yīng)將main()放在最前面,并明確用void聲明參數(shù)和返回值。
對(duì)由多個(gè).c文件組成的模塊程序或完整監(jiān)控程序,建立公共引用頭文件,將需要引用的庫(kù)頭文件、標(biāo)準(zhǔn)寄存器定義頭文件、自定義的頭文件、全局變量等均包含在內(nèi),供每個(gè)文件引用。通常,標(biāo)準(zhǔn)函數(shù)庫(kù)頭文件采用尖角號(hào)< >標(biāo)志文件名,自定義頭文件采用雙撇號(hào)″″標(biāo)志文件名。
每個(gè).c文件有一個(gè)對(duì)應(yīng)的.h文件,.c文件的注釋之后首先定義一個(gè)唯一的文件標(biāo)志宏,并在對(duì)應(yīng)的.h文件中解析該標(biāo)志。
在.c文件中:
#define FILE_FLAG
在.h文件中:
#ifdef FILE_FLAG
#define XXX
#else
#define XXX extern
#endif
對(duì)于確定只被某個(gè).c文件調(diào)用的定義可以單獨(dú)列在一個(gè)頭文件中、單獨(dú)調(diào)用。
9.2可重入函數(shù)
可重入函數(shù)中若使用了全局變量,應(yīng)通過(guò)關(guān)中斷、信號(hào)量等操作手段對(duì)其加以保護(hù)。
9.3函數(shù)的形參
由函數(shù)調(diào)用者負(fù)責(zé)檢查形參的合法性。
盡量避免將形參作為工作變量使用。
9.4循環(huán)
盡量減少循環(huán)嵌套層數(shù)
在多重循環(huán)中,應(yīng)將最忙的循環(huán)放在最內(nèi)層
循環(huán)體內(nèi)工作量最小
盡量避免循環(huán)體內(nèi)含有判斷語(yǔ)句






歡迎光臨 (http://www.zg4o1577.cn/bbs/) Powered by Discuz! X3.1
主站蜘蛛池模板: 在线观看亚 | 欧美日韩在线免费观看 | 亚洲成人播放器 | 亚洲国产一区二区三区四区 | av在线播放免费 | 中文字幕精品一区久久久久 | 国产精品成人一区二区三区夜夜夜 | 亚洲精品在线免费播放 | 密乳av| 亚洲免费一区二区 | 亚洲精品福利视频 | 国产福利小视频 | 精精国产视频 | av在线一区二区 | 国产ts人妖另类 | 91成人在线视频 | 亚洲精品久久久久中文字幕二区 | 麻豆视频在线看 | 国产美女在线免费观看 | 中文字幕 亚洲一区 | 黄色大片在线播放 | 久热国产在线 | 久久精品视频网站 | 午夜爽爽男女免费观看hd | 99精品免费| 91精品久久久久久久久久入口 | 一级黄色片日本 | www.av在线 | 日韩欧美亚洲一区 | 一区二区三区四区在线视频 | 少妇精品亚洲一区二区成人 | 国产在线高清 | 少妇一区在线观看 | 在线播放国产一区二区三区 | 国产免费一区二区 | 黄网站在线播放 | 91久久精品一区二区二区 | 婷婷成人在线 | 成人精品一区二区三区中文字幕 | 精品亚洲91| 亚洲精品一区二区 |