作為一個初學者如何具有良好的程序設計風格呢?我想引用一個關于初學者請教編程大師的故事讓讀者自己去領悟。
有一位編程大師,他寫非結構化的程序,一位初學者刻意模仿他,也寫非結構化的程序。當他讓大師看他的進步時,大師批評了他的非結構化程序:“ 對一位編程大師合適的東西未必對一個初學者同樣合適,在超越結構化之前,你必須理解編程之道?!?我個人認為作為一個初學者應該踏踏實實的打好程序設計的基礎,不要急功近利,舍本逐末。我走過不少彎路,希望大家能和我一樣能牢記編程大師的忠告:“對編程大師合適的東西未必對一個初學者同樣合適”。
本文所描述的優(yōu)秀編程風格適合于大部分語言,文章中可能提到你不是很了解的概念,沒有關系,你放心的讀下去,當你使用AVR一個月之后,你什么都明白了。
AVR c語言優(yōu)秀編程風格
文件結構
模塊化的程序應該是有一個很好的程序結構的。AVR C語言程序有兩種用戶文件,.c程序文件,.h頭文件,程序中編寫過程中需要在.c文件中包含.h頭文件。初學者往往出現(xiàn)重復包含或者頭文件包含錯誤的問題,我當時也時常為這種錯誤而發(fā)愁。下面我以我寫的電機驅動例程來給大家說明一下,優(yōu)秀的編程文件結構。
這個工程中有8個文件,一個說明文件,如下圖:下載程序例子 電機控制案例 。
我寫的成型的程序的文件個數(shù)基本上都是偶數(shù),因為每一個結構化的函數(shù)定義.c文件都會對應一個.h文件。main.c對應config.h。我們來看看各文件的包含關系。下面我們看看這些文件的包含關系與內(nèi)容:[推薦的文件包含順序與關系]
所有.c文件都包含了config.h文件。如: #include "config.h"
在config.h 中有如下代碼:
#include"delay.h" #include"devICe_init.h" #include"motor.h"
這樣做就不容易出現(xiàn)錯誤的包含關系,為了預防萬一,我們還引入了宏定義與預編譯。如下:
#ifndef_UNIT_H__ #define_UNIT_H__1 //100us externvoidDelay100us(uint8n); //1s externvoidDelay1s(uint16n);//n<=6,whenn==7,itis1. //1ms externvoidDelay1ms(uint16n); #endif 第一次包含本文件的時候正確編譯,并且#define_UNIT_H__1,第二次包含本文件#ifndef_UNIT_H__就不再成立,跳過文件。 預編譯還有更多的用途,比如可以根據(jù)不同的值編譯不同的語句,如下: //#pragmaREGPARMS #ifCPU_TYPE==M128 #include
#endif #ifCPU_TYPE==M64 #include #endif #ifCPU_TYPE==M32 #include #endif #ifCPU_TYPE==M16 #include #endif #ifCPU_TYPE==M8 #include #endif #include
與 #include "filename" 的區(qū)別 :前者是包含系統(tǒng)目錄include下 的文件,后者是包含程序目錄下的文件。
變量名與函數(shù)名
變量以及函數(shù)命名應該按照 盡量短 , 按需長 , 具有實際意義 。可以通過下劃線或者大小寫結合的方法組合動詞和名詞組成變量函數(shù)名。下面對比好的命名方法與不好的命名方法:
好的:Delay100us();
不好的:Yanshi();好的:init_devices();
不好的:Chengxuchushihua();好的:int temp;
不好的:int dd;
外部調用
首先在模塊化程序的.h文件中定義 extern
//端口初始化 externvoidport_init(void); //T2初始化 voidtimer2_init(void); //各種參數(shù)初始化 externvoidinit_devices(void);
模塊化程序的.c文件中定義函數(shù), 不要在模塊化的程序中調用程序 ,及不要出現(xiàn)向timer2_init();這樣函數(shù)的使用,因為你以后不知道你到底什么地方調用了函數(shù),導致程序調試難度增加??梢栽诙x函數(shù)的過程中調用其他函數(shù)作為函數(shù)體。
/**************************采用timer2產(chǎn)生波形***********************/ //PWM頻率=系統(tǒng)時鐘頻率/(分頻系數(shù)*2*計數(shù)器上限值)) voidtimer2_init(void) { TCCR2=0x00;//stop TCNT2=0x01;//setcount OCR2=0x66;//setcompare TCCR2=(1<
在少數(shù)幾個文件中調用函數(shù),在main.c中調用大部分函數(shù),在interupts.c中根據(jù)不同的中斷調用服務函數(shù)。
voidmain(void) { /******************************************************************************/ //初始工作 /******************************************************************************/ init_devices(); while(1) { for_ward(0); //默認速度運轉正 Delay1s(5); //延時5s motor_stop(); //停止 Delay1s(5); //延時5s back_ward(0); //默認速度運轉反 Delay1s(5); //延時5s speed_add(20); //加速 Delay1s(5); //延時5s speed_subtract(20); //減速 Delay1s(5); //延時5s } }
宏定義
宏定義主要用于兩個地方:
一是用得非常多的命令或語句,利用宏將其簡化。
#ifndefTRUE #defineTRUE1 #endif #ifndefFALSE #defineFALSE0 #endif #ifndefNULL #defineNULL0 #endif #defineMIN(a,b) ((ab)?(a):(b)) #defineABS(x) ((x>)?(x):(-x)) typedefunsignedcharuint8;/*定義可移植的無符號8位整數(shù)關鍵字*/ typedefsignedcharint8;/*定義可移植的有符號8位整數(shù)關鍵字*/ typedefunsignedintuint16;/*定義可移植的無符號16位整數(shù)關鍵字*/ typedefsignedintint16;/*定義可移植的有符號16位整數(shù)關鍵字*/ typedefunsignedlonguint32;/*定義可移植的無符號32位整數(shù)關鍵字*/ typedefsignedlongint32;/*定義可移植的有符號32位整數(shù)關鍵字*/
二是利用宏定義方便的進行硬件接口操作,再程序需要修改時,只需要修改宏定義即可,而不需要滿篇去找命令行,進行修改。
//PD4,PD5電機方向控制如果更改管腳控制電機方向,更改PORTD|=0x10即可。 #definemoto_en1PORTD|=0x10 #definemoto_en2PORTD|=0x20 #definemoto_uen1PORTD&=~0x10 #definemoto_uen2PORTD&=~0x20 //啟動TC2定時比較和溢出 #defineTC2_ENTIMSK|=(<<1OCIE2)|(1<
關于注釋
為了增加程序的可讀性,方便合作者讀動程序,或者程序作者在一段時間之后還能看懂程序,我們需要在程序中寫 注釋。
在比較特殊的函數(shù)使用或者命令調用的地方加單行注釋。使用方法為:
Tbuf_putchar(c,RTbuf);//將數(shù)據(jù)加入到發(fā)送緩沖區(qū)并開中斷 externvoidDelay1s(uint16n);//n<=6,whenn==7,itis1.