Bootstrap

头文件中的宏定义

在工程中,写一个模块,师傅说,头文件按找下面格式写。

知其然而不知其所以然,看到条件编译就犯晕。

下面是学习后的理解和收获,分享给大家。

代码:

 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();

  

这种用法既防止了重复包含,也防止了变量重复定义的错误,外部变量、外部函数也只仅仅在一个头文件中声明,而其他文件只仅仅包含该文件即可。

这个方法也间接的方便了工程的管理。

 

 

转载于:https://www.cnblogs.com/zhengluyao/p/7958628.html

;