簡(jiǎn)介:編程首要是要考慮程序的可行性,然后是可讀性、可移植性、健壯性以及可測(cè)試性。這是總則。但是很多人忽略了可讀性、可移植性和健壯性(可調(diào)試的方法可能歌不相同),這是不對(duì)的。 下面就來(lái)說(shuō)說(shuō)有關(guān)C51的編程規(guī)范問(wèn)題。
1.當(dāng)項(xiàng)目比較大時(shí),最好分模塊編程,一個(gè)模塊一個(gè)程序,很方便修改,也便于重用和便于閱讀。
2.每個(gè)文件的開(kāi)頭應(yīng)該寫(xiě)明這個(gè)文件是哪個(gè)項(xiàng)目里的哪個(gè)模塊,是在什么編譯環(huán)境下編譯的,編程者(/修改者)和編程日期,值得注意的是一定不要忘了編程日期,因?yàn)橐院竽阍倏次募r(shí),會(huì)知道大概是什么時(shí)候編寫(xiě)的,有些什么功能,并且可能知道類(lèi)似模塊之間的差異(有時(shí)同一模塊所用的資源不同,和單片機(jī)相連的方法也不同,或者只是在原有的模塊上加以改進(jìn))。
3.一個(gè)C源文件配置一個(gè)h頭文件或者整個(gè)項(xiàng)目的C文件配置一個(gè)h頭文件,我自己采用整個(gè)項(xiàng)目的C文件配置一個(gè)h頭文件的方法,并且使用#ifndef/#define/#endif的宏來(lái)防止重復(fù)定義,方便各模塊之間相互調(diào)用。
4.一些常量(如圓周率PI)或者常需要在調(diào)試時(shí)修改的參數(shù)最好用#define定義,但要注意宏定義只是簡(jiǎn)單的替換,因此有些括號(hào)不可少。
5.不要輕易調(diào)用某些庫(kù)函數(shù),因?yàn)橛行?kù)函數(shù)代碼很長(zhǎng)(我是反對(duì)使用printf之類(lèi)的庫(kù)函數(shù)的,但是是一家之言,并不勉強(qiáng)各位)。
6.書(shū)寫(xiě)代碼時(shí)要注意括號(hào)對(duì)齊,固定縮進(jìn),一個(gè){}各占一行,我本人采用采用所進(jìn)4個(gè)字符,應(yīng)該還是比較合適的,if/for/while/do等語(yǔ)句各占一行,執(zhí)行語(yǔ)句不得緊跟其后,無(wú)論執(zhí)行語(yǔ)句多少都要加{},千萬(wàn)不要寫(xiě)成如下格式:
for(i=0;i<100;i++){fun1();fun2();}
for(i=0;i<100;i++){
fun1();
fun2();
}
而應(yīng)該寫(xiě)成:
for(i=0;i<100;i++)
{
fun1();
fun2();
}
7.一行只實(shí)現(xiàn)一個(gè)功能,比如:
a=2;b=3;c=4;宜改成:
a=2;
b=3;
c=4;
8.重要難懂的代碼要寫(xiě)注釋?zhuān)總€(gè)函數(shù)要寫(xiě)注釋?zhuān)總€(gè)全局變量要寫(xiě)注釋?zhuān)恍┚植孔兞恳惨獙?xiě)注釋。注釋寫(xiě)在代碼的上方或者右方,千萬(wàn)不要寫(xiě)在下方(相信沒(méi)有人寫(xiě)在左方吧:))。
9.對(duì)各運(yùn)算符的優(yōu)先級(jí)右所了解,記不得沒(méi)關(guān)系,加括號(hào)就是,千萬(wàn)不要自作聰明說(shuō)自己記得很牢。
10.不管有沒(méi)有無(wú)效分支,switch函數(shù)一定要defaut這個(gè)分支。一來(lái)讓閱讀者知道程序員并沒(méi)有遺忘default,并且防止程序運(yùn)行過(guò)程中出現(xiàn)的意外(健壯性)。
11.變量和函數(shù)的命名最好能做到望文生義。不要命名什么x,y,z,a,sdrf之類(lèi)的名字。
12.函數(shù)的參數(shù)和返回值沒(méi)有的話最好使用void。
13.goto語(yǔ)句:從匯編轉(zhuǎn)型成C的人很喜歡用goto,但goto是C語(yǔ)言的大忌,但是老實(shí)說(shuō),程序出錯(cuò)是程序員自己造成的,不是goto的過(guò)錯(cuò);本人只推薦一種情況下使用goto語(yǔ)句,即從多層循環(huán)體中跳出。
14.指針是C語(yǔ)言的精華,但是在C51中我個(gè)人認(rèn)為少用為妙,一來(lái)有時(shí)反而要花費(fèi)多的空間,還有在對(duì)片外數(shù)據(jù)進(jìn)行操作時(shí)會(huì)出錯(cuò)(可能是時(shí)序的問(wèn)題)。
15.一些常數(shù)和表格之類(lèi)的應(yīng)該放到code去中以節(jié)省RAM。
16.程序編完編譯看有多少code多少data,注意不要使堆棧為難。
17.程序應(yīng)該要能方便的進(jìn)行測(cè)試,其實(shí)這也與編程的思維有關(guān);一般有三種:一種是自上而下先整體再局部;一種是自下而上先局部再整體;還有一種是結(jié)合兩者往中間湊。我的做法是現(xiàn)大概規(guī)劃一下整個(gè)編程,然后一個(gè)模塊模塊獨(dú)立編程,每個(gè)模塊調(diào)試成功再拼湊在一塊調(diào)試。我建議:如果程序不大,可以直接用一個(gè)文件直接編,如果程序很大,宜采用自上而下的方式,但更多的是那種處在中間的情況,宜采用自下而上或者結(jié)合的方式。
二、命名:
命名必須具有一定的實(shí)際意義。
1、常量的命名:全部用大寫(xiě)。
2、變量的命名:
變量名加前綴,前綴反映變量的數(shù)據(jù)類(lèi)型,用小寫(xiě),反映變量意義的第一個(gè)字母大寫(xiě),其他小寫(xiě)。
其中變量數(shù)據(jù)類(lèi)型:
unsigned char 前綴 uc signed char 前綴 sc
unsigned int 前綴 ui signed int 前綴 si
unsigned long 前綴 ul signed long 前綴 sl
bit 前綴 b 指針 前綴 p
例:ucReceivData 接收數(shù)據(jù)
3、結(jié)構(gòu)體命名:
4、函數(shù)的命名:
函數(shù)名首字大寫(xiě),若包含有兩個(gè)單詞的每個(gè)單詞首字母大寫(xiě)。
函數(shù)原型說(shuō)明包括:引用外來(lái)函數(shù)及內(nèi)部函數(shù),外部引用必須在右側(cè)注明函數(shù)來(lái)源: 模塊名及文件名, 內(nèi)部函數(shù),只要注釋其定義文件名;
三、編輯風(fēng)格
1、縮進(jìn):縮進(jìn)以 Tab 為單位,一個(gè) Tab 為四個(gè)空格大小。預(yù)處理語(yǔ)句、全局?jǐn)?shù)據(jù)、函數(shù)原型、標(biāo)題、附加說(shuō)明、函數(shù)說(shuō)明、標(biāo)號(hào)等均頂格書(shū)寫(xiě)。語(yǔ)句塊的“{”“}”配對(duì)對(duì)齊,并與其前一行對(duì)齊;
2、空格:數(shù)據(jù)和函數(shù)在其類(lèi)型,修飾名稱(chēng)之間適當(dāng)空格并據(jù)情況對(duì)齊。關(guān)鍵字原則上空一格,如:
if ( ... ) 等,運(yùn)算符的空格規(guī)定如下:“->”、“[”、“]”、“++”、“--”、“~”、“!”、“+”、“-”(指正負(fù)號(hào)),“&”(取址或引用)、“*”(指使用指針時(shí))等幾個(gè)運(yùn)算符兩邊不空格(其中單目運(yùn)算符系指與操作數(shù)相連的一邊),其它運(yùn)算符(包括大多數(shù)二目運(yùn)算符和三目運(yùn)算符“?:”兩邊均空一格,“(”、“)”運(yùn)算符在其內(nèi)側(cè)空一格,在作函數(shù)定義時(shí)還可據(jù)情況多空或不空格來(lái)對(duì)齊,但在函數(shù)實(shí)現(xiàn)時(shí)可以不用。“,”運(yùn)算符只在其后空一格,需對(duì)齊時(shí)也可不空或多空格,對(duì)語(yǔ)句行后加的注釋?xiě)?yīng)用適當(dāng)空格與語(yǔ)句隔開(kāi)并盡可能對(duì)齊。
3、對(duì)齊:原則上關(guān)系密切的行應(yīng)對(duì)齊,對(duì)齊包括類(lèi)型、修飾、名稱(chēng)、參數(shù)等各部分對(duì)齊。另每一行的長(zhǎng)度不應(yīng)超過(guò)屏幕太多,必要時(shí)適當(dāng)換行,換行時(shí)盡可能在“,”處或運(yùn)算符處,換行后最好以運(yùn)算符打頭,并且以下各行均以該語(yǔ)句首行縮進(jìn),但該語(yǔ)句仍以首行的縮進(jìn)為準(zhǔn),即如其下一行為“{”應(yīng)與首行對(duì)齊。
4、空行:程序文件結(jié)構(gòu)各部分之間空兩行,若不必要也可只空一行,各函數(shù)實(shí)現(xiàn)之間一般空兩行
5、修改:版本封存以后的修改一定要將老語(yǔ)句用/* */ 封閉,不能自行刪除或修改,并要在文件及函數(shù)的修改記錄中加以記錄。
6、形參:在定義函數(shù)時(shí),在函數(shù)名后面括號(hào)中直接進(jìn)行形式參數(shù)說(shuō)明,不再另行說(shuō)明。
上一篇:總結(jié)單片機(jī)軟件抗干擾的幾種辦法
下一篇:基于藍(lán)牙技術(shù)的汽車(chē)駕駛盤(pán)控制系統(tǒng)
推薦閱讀
史海拾趣
廣州西博臣科技有限公司(簡(jiǎn)稱(chēng)西博臣)成立于2001年,從創(chuàng)立之初就專(zhuān)注于濕度傳感器的研發(fā)和生產(chǎn)。公司是國(guó)內(nèi)最早從事高分子濕度傳感器研發(fā)并進(jìn)行規(guī)模化生產(chǎn)的廠家之一,憑借其獨(dú)特的技術(shù)實(shí)力和對(duì)行業(yè)的深刻理解,逐漸在市場(chǎng)中嶄露頭角。
隨著市場(chǎng)競(jìng)爭(zhēng)的加劇,Datatronic公司意識(shí)到單純依靠技術(shù)創(chuàng)新已不足以保持競(jìng)爭(zhēng)優(yōu)勢(shì)。于是,公司開(kāi)始調(diào)整市場(chǎng)策略,注重與客戶(hù)的溝通和合作。通過(guò)深入了解客戶(hù)需求,公司能夠提供更符合市場(chǎng)需求的定制化產(chǎn)品和服務(wù)。同時(shí),公司還加強(qiáng)了與上下游企業(yè)的合作,形成了穩(wěn)定的供應(yīng)鏈體系。
隨著市場(chǎng)競(jìng)爭(zhēng)的加劇,Datatronic公司意識(shí)到單純依靠技術(shù)創(chuàng)新已不足以保持競(jìng)爭(zhēng)優(yōu)勢(shì)。于是,公司開(kāi)始調(diào)整市場(chǎng)策略,注重與客戶(hù)的溝通和合作。通過(guò)深入了解客戶(hù)需求,公司能夠提供更符合市場(chǎng)需求的定制化產(chǎn)品和服務(wù)。同時(shí),公司還加強(qiáng)了與上下游企業(yè)的合作,形成了穩(wěn)定的供應(yīng)鏈體系。
隨著全球化趨勢(shì)的加速,Datatronic公司開(kāi)始將目光投向國(guó)際市場(chǎng)。公司通過(guò)參加國(guó)際展覽、設(shè)立海外辦事處等方式,積極拓展海外市場(chǎng)。同時(shí),公司還加強(qiáng)了與國(guó)際企業(yè)的合作,引進(jìn)先進(jìn)的技術(shù)和管理經(jīng)驗(yàn)。這些努力使得Datatronic公司在國(guó)際市場(chǎng)上逐漸獲得了認(rèn)可,品牌影響力得到了提升。
Hendon Semiconductors以其強(qiáng)大的定制化集成電路設(shè)計(jì)能力而聞名。公司擁有一支經(jīng)驗(yàn)豐富的設(shè)計(jì)團(tuán)隊(duì),能夠?yàn)榭蛻?hù)提供從概念到量產(chǎn)的一站式解決方案。這種定制化服務(wù)不僅滿足了客戶(hù)對(duì)特殊功能和高性能的需求,也幫助Hendon Semiconductors在競(jìng)爭(zhēng)激烈的市場(chǎng)中脫穎而出。通過(guò)不斷積累成功案例和技術(shù)經(jīng)驗(yàn),Hendon Semiconductors逐漸在定制化集成電路設(shè)計(jì)領(lǐng)域建立了良好的口碑。
在技術(shù)創(chuàng)新方面,EAO公司一直走在行業(yè)前列。公司擁有一支高素質(zhì)的研發(fā)團(tuán)隊(duì),不斷探索新技術(shù)、新材料和新工藝在電子產(chǎn)品中的應(yīng)用。通過(guò)技術(shù)創(chuàng)新,EAO公司不斷推出具有市場(chǎng)競(jìng)爭(zhēng)力的新產(chǎn)品,滿足客戶(hù)不斷變化的需求。同時(shí),公司還積極與高校、科研機(jī)構(gòu)等合作,共同推動(dòng)電子行業(yè)的科技進(jìn)步。
ISD4004語(yǔ)音芯片在語(yǔ)音報(bào)站器中的應(yīng)用 摘要:ISD4004語(yǔ)音系列芯片是美國(guó)ISD公司推出的產(chǎn)品,具有可多次重復(fù)錄放、存儲(chǔ)時(shí)間長(zhǎng)、使用時(shí)不需擴(kuò)充存儲(chǔ)器、所需外圍電路簡(jiǎn)單等特點(diǎn)。介紹了ISD4004芯片在語(yǔ)音報(bào)站器中的一個(gè)實(shí)際應(yīng)用,并說(shuō)明了其功能和使用方法,從而使讀者對(duì) ...… 查看全部問(wèn)答∨ |
高端訪談----與職場(chǎng)領(lǐng)袖分享工作“秘笈” 求職、面試、薪水、跳槽。無(wú)論剛畢業(yè)的學(xué)生,還是職場(chǎng)老兵都將是不得不面對(duì)的問(wèn)題。如何在眾多競(jìng)爭(zhēng)對(duì)手中脫穎而出?如何在邁入公司第一步的同時(shí)就能對(duì)該企業(yè)有個(gè)全面的了解,談妥自己期望的薪金?如何撰寫(xiě)出一份漂亮的簡(jiǎn)歷,闖過(guò)人事部門(mén)的第一關(guān)? ...… 查看全部問(wèn)答∨ |
工作機(jī)會(huì) Wince/WM 驅(qū)動(dòng)開(kāi)發(fā)工程師 北京 如題,工作機(jī)會(huì) Wince/WM 驅(qū)動(dòng)開(kāi)發(fā)工程師 北京 要求有Wince/WM驅(qū)動(dòng)開(kāi)發(fā)經(jīng)驗(yàn) 有意者聯(lián)系koalor_girl@hotmail.com… 查看全部問(wèn)答∨ |
我在Linux下用read()讀串口時(shí),若串口的數(shù)據(jù)中有0x0D時(shí),發(fā)現(xiàn)無(wú)法讀到0x0D后的數(shù)據(jù),請(qǐng)教大家應(yīng)該如何解決??? 串口設(shè)置如下,其他的數(shù)據(jù)位、校驗(yàn)等未設(shè)置 tcgetattr(spfd,&oldtio); cfmakeraw(&oldtio); cfsetispeed(&oldtio,B9600) ...… 查看全部問(wèn)答∨ |
platform builder4.2 如何調(diào)試驅(qū)動(dòng)程序?? platform builder4.2 如何調(diào)試驅(qū)動(dòng)程序?? 我想讓設(shè)備運(yùn)行debug版wince,然后在串口驅(qū)動(dòng)設(shè)置斷點(diǎn),之后單步調(diào)試,請(qǐng)問(wèn)步驟如何,能否說(shuō)得具體點(diǎn).我編譯時(shí)候選擇kitl了,可是通過(guò)網(wǎng)口下載到設(shè)備后怎么設(shè)置斷點(diǎn)啊??????? 搞了半個(gè)月了,暈倒了.大家?guī)兔?...… 查看全部問(wèn)答∨ |
我做了一個(gè)程序,程序主要是實(shí)現(xiàn)登陸密碼的各種功能,密碼是存在一個(gè).TXT文件中的,現(xiàn)在生成的文件是可見(jiàn)的,怎么能通過(guò)修改代碼讓其生成文件是隱藏的? 當(dāng)然不能在磁盤(pán)中右鍵點(diǎn)文件屬性設(shè)置啦,嘿嘿 那,創(chuàng)建文件代碼是這樣的: CString strTem ...… 查看全部問(wèn)答∨ |
我開(kāi)發(fā)的板子是C6202B的,用的是xds510 PCI的仿真器,ccs2.2.018開(kāi)發(fā)軟件,我的dsp剛開(kāi)始是可以load program的,我接著data-〉save保存程序區(qū)和數(shù)據(jù)區(qū),程序區(qū)的起始地址是0x00000000,長(zhǎng)度為0x00008000,保存沒(méi)有問(wèn)題。數(shù)據(jù)區(qū)的起始地址設(shè)為0x8000 ...… 查看全部問(wèn)答∨ |
程序長(zhǎng)時(shí)間運(yùn)行問(wèn)題 我最近在寫(xiě)一個(gè)程序,程序先從main函數(shù)開(kāi)始執(zhí)行,然后調(diào)用一個(gè)子程序,然后一直在子程序里運(yùn)行,這樣長(zhǎng)時(shí)間運(yùn)行的話,會(huì)不會(huì)有問(wèn)題? … 查看全部問(wèn)答∨ |
整理一下前面發(fā)的帖子,搞個(gè)總帖,方便大家交流。 1. BeagleBone 硬件性能測(cè)試 _周計(jì)劃 http://bbs.eeworld.com.cn/thread-324885-1-1.html 2. BeagleBone 硬件性能測(cè)試(1) ---- 我是出來(lái)打醬油的 http://bbs.eeworld.com.cn/thread-325363-1-1 ...… 查看全部問(wèn)答∨ |
設(shè)置完發(fā)送觸發(fā)深度中斷后,當(dāng)還沒(méi)有開(kāi)始發(fā)數(shù)據(jù),那FIFO是空的,是不是就馬上進(jìn)入發(fā)送中斷了?如果這時(shí)候不想發(fā)送數(shù)據(jù)呢… 查看全部問(wèn)答∨ |
設(shè)計(jì)資源 培訓(xùn) 開(kāi)發(fā)板 精華推薦
- 【下載】LAT1466 USB x Device HID Standalone的移植
- 【下載】LAT1488 STM32 USBxDevice MSC standalone移植示例
- 【下載】LAT1482 STM32G0單線串口通信幀錯(cuò)誤問(wèn)題解析
- 【下載】LAT1473 STM32C0 HAL庫(kù)的SPI 驅(qū)動(dòng)導(dǎo)致的Hardfault問(wèn)題分析
- 【下載】LAT1490 兩個(gè)STM32G0 I2C 通信異常的案例分析
- 【下載】LAT1470 SPI傳輸長(zhǎng)度超過(guò)1024時(shí)出現(xiàn)異常的問(wèn)題分析
- STM32一文通(6) 外部中斷
- ESP32玩轉(zhuǎn)MicroPython(一) 燒入固件, 初識(shí)
- ESP32玩轉(zhuǎn)MicroPython(二) 連接WIFI網(wǎng)絡(luò) webperl文件傳輸
- ESP32玩轉(zhuǎn)MicroPython(三) 延時(shí)、計(jì)時(shí) 和GPIO操作
- 玩轉(zhuǎn) ESP32 + Arduino (一) 開(kāi)發(fā)環(huán)境搭建
- 玩轉(zhuǎn) ESP32 + Arduino (四) 電容按鍵 霍爾傳感器 外部中斷 延時(shí) 脈沖檢測(cè)
- 玩轉(zhuǎn) ESP32 + Arduino (五) platformIO引入類(lèi)庫(kù) 自開(kāi)發(fā)庫(kù) 串口打印字符串
- 玩轉(zhuǎn) ESP32 + Arduino (六) 硬件定時(shí)器, IIC, SPI
- 玩轉(zhuǎn) ESP32 + Arduino (八) U8G2驅(qū)動(dòng)OLED
- 超快充技術(shù)平權(quán)時(shí)代,要來(lái)了
- 智元機(jī)器人與Physical Intelligence(Pi)達(dá)成戰(zhàn)略合作
- 不到10萬(wàn)塊!特斯拉再次面臨生死狙擊?
- 高階智駕NOA功能解析:技術(shù)架構(gòu)與實(shí)現(xiàn)路徑
- 智能體爆發(fā)元年,誰(shuí)在“無(wú)人區(qū)”繪制地形圖?
- 億緯鋰能大圓柱電池進(jìn)展:良率突破97%
- 500Wh/kg電池競(jìng)速:鋰金屬電池挑戰(zhàn)全固態(tài)共識(shí)?(下)
- 500Wh/kg電池競(jìng)速:鋰金屬電池挑戰(zhàn)全固態(tài)共識(shí)?(上)
- 密歇根大學(xué)突破:低溫充電速度提升500%
- 谷歌發(fā)布Android Auto 14.0更新,界面優(yōu)化并準(zhǔn)備車(chē)機(jī)版Gemini AI
- 下載有禮!是德科技5G精選解決方案,幫您勘破 5G 迷宮!
- 不可錯(cuò)過(guò)的一次邂逅,TTI攜TE傳感器樣片與你相見(jiàn)!免費(fèi)樣片申請(qǐng)活動(dòng)開(kāi)始啦~
- 有獎(jiǎng)直播|安森美先進(jìn)的封裝和驅(qū)動(dòng)技術(shù)助力碳化硅能源應(yīng)用
- 2019東芝PCIM在線展會(huì):會(huì)一會(huì) 電力領(lǐng)域中的高能晶體管們
- HDMI/ DP2.0 線上實(shí)測(cè)研討會(huì)|是德科技
- 任選下載有禮|《新概念模擬電路》全五冊(cè)合集/《ADI 參考電路合集》
- ADI有獎(jiǎng)下載活動(dòng)之18 ADI雙光束分光光度計(jì)演示系統(tǒng)和解決方案
- Vicor 更好的供電方式提升無(wú)人機(jī)飛行時(shí)間飛行半徑及有效載荷
- 迎端午,芯幣可以?xún)稉Q粽子啦!
- Platform builder5.0中那些網(wǎng)絡(luò)組件跟WIFI相關(guān)?
- 單片機(jī)與PC機(jī)電話遠(yuǎn)程通信系
- 壓力檢測(cè)與變送
- Atmel SAM D21開(kāi)發(fā)板試用心得+開(kāi)發(fā)板驅(qū)動(dòng)SSD1306 OLED
- 參加TI 2013 研討會(huì)的參加禮品
- 這兩個(gè)電路結(jié)構(gòu)對(duì)比
- 曬WEBENCH設(shè)計(jì)的過(guò)程+寬輸入范圍SPEIC電源設(shè)計(jì)
- TI LM3S8962開(kāi)發(fā)板套件,怎么給小板加載程序呢?
- 請(qǐng)教兩個(gè)errorno:0x41,0xd0003
- 運(yùn)放輸入可以超出電源供電范圍嗎?