在工程中,寫一個模塊,師傅說,頭文件按找下面格式寫。
知其然而不知其所以然,看到條件編譯就犯暈。
下面是學習后的理解和收獲,分享給大家。
代碼:
1 #ifndef DSP_ADC_BSP_H_ //防止頭文件被重復包含 2 #define DSP_ADC_BSP_H_ 3 4 #ifdef _DSP_ADC_BSP_C_ //判斷是否被定義了 5 #define ADCBSPEXT //定義時執行 6 #else 7 #define ADCBSPEXT extern //未定義時執行 8 #endif //_DSP_ADC_BSP_C_ 9 ADCBSPEXT int a;
10 ADCBSPEXT void InitileAdc(void);
11 ADCBSPEXT void CaptureAdcInt();
12 ADCBSPEXT unsigned char CaptureAdcInt_data();
13
14 #endif /* DSP_ADC_BSP_H_ */
解釋:
第1、2行和第14行:防止重復包含。
#ifndef DSP_ADC_BSP_H_ //如果DSP_ADC_BSP_H_沒有被定義,則執行以下
#define DSP_ADC_BSP_H_ //定義DSP_ADC_BSP_H_
...
#endif /* DSP_ADC_BSP_H_ */ //注解是給程序員指明對應的#ifndef指令。
同一個文件,在首次包含這個文件時,沒有定義宏DSP_ADC_BSP_H_,預處理器允許保留#ifndef和#endif之間的多行內容。
如果再次包含此文件,預處理器將把#ifndef和#endif之間的內容刪除。
意思是文件包含的頭文件中又同時包含了該.h文件,該文件只會定義一次。
第3~12行:提供只在一個.h文件中定義一次就可以在別的模塊中使用外部函數與變量的方法。(別的文件需要包含該頭文件)
首先說明一下extern:
extern int i;
extern的用法:
1、變量
extern int a;//聲明一個全局變量a
int a; //定義一個全局變量a
extern int a =0 ;//定義一個全局變量a 並給初值。一旦給予賦值,一定是定義,定義才會分配存儲空間。
int a =0;//定義一個全局變量a,並給初值,
該聲明編譯器提供的信息是,i 是int型變量 但是編譯器不會為i分配存儲單元。上述聲明不是變量的定義,而是提示編譯器需要訪問定義在別處的變量。
變量在程序中可以多次聲明,但只能有一次定義。
2、函數
extern int func(void);
和
int func(void); 含義一樣
對於函數來說,沒有實體默認為聲明
extern可有可無
下面是正題:
#ifdef _DSP_ADC_BSP_C_ //判斷_DSP_ADC_BSP_C_是否被定義
#define ADCBSPEXT //如果定義了執行,ADCBSPEXT為空白
#else
#define ADCBSPEXT extern //如果沒有定義執行,ADCBSPEXT為extern
#endif
ADCBSPEXT int i;
ADCBSPEXT void InitileAdc(void); //函數的聲明中,ADCBSPEXT可有可無,習慣加上。
ADCBSPEXT void CaptureAdcInt();
ADCBSPEXT unsigned char CaptureAdcInt_data();
在與之對應模塊的.c文件中會有這么一句話:
#define _DSP_ADC_BSP_C_ //定義了_DSP_ADC_BSP_C_
那么當為本模塊.c文件時,ADCBSPEXT替換為空白。
聲明就是:
int a;
void InitileAdc(void); void CaptureAdcInt(); unsigned char CaptureAdcInt_data();
當為其他.c文件用到這些函數式、外部變量,就需要包含這個頭文件,而其中的ADCBSPEXT替換為extern以提供使用。
extern int a;
extern void InitileAdc(void); extren void CaptureAdcInt(); extern unsigned char CaptureAdcInt_data();
這種用法既防止了重復包含,也防止了變量重復定義的錯誤,外部變量、外部函數也只僅僅在一個頭文件中聲明,而其他文件只僅僅包含該文件即可。
這個方法也間接的方便了工程的管理。