#define的用法总结

先来讲一讲#define的优点与缺点: 
[优点] 
当在程序中想要修改某一个值得时候,而且这个值又在很多地方引用。这时候就能体现出宏定义的强大优点了。 
例如:

#define LINK LED0   //定义LINK的灯为LED0
 
 
  • 1

因为在程序中我们可能很多地方要对LINK灯进行操作,当我们想换LINK灯的时候,直接将:

#define LINK LED1
 
 
  • 1

这样就很方便了,不用一处处去找,而且不用担心有漏掉的可能。 
[缺点] 
宏定义有一些缺点: 
(1) 无法对宏定义中的变量进行类型检查 
此缺点,是相对于const变量来说的 
[define与const的区别的简单总结]

define定义的变量,是Compile-Time时期的变量,系统在编译时候,就将其全部替换,而不会对其变量进行类型等属性检查,相对不是很安全,可能存在潜在的问题,而没有发现. 
正因为其仅仅是编译时期替换,所以其定义的变量,是不会在运行时候分配内存的,不占用内存空间. 
const定义的变量,是 Run-Time时期的变量,如果类型不匹配,系统在运行时候,就会发现并提示或报错,对应的,const变量在运行时期,也是一种变量,系统会为其分配内存. 
(2) 边界效应 
A. 未加括号带来的边界效应 
由于宏定义的时候,其各个分量未加括号,而在使用宏定义的时候,传递的参数是变量的表达式,然后经过系统展开后,由于优先级的原因,导致其结果不是你所希望的. 
[例子]

#define MUL(A,B) A*B
 
 
  • 1

而在使用的时候,这样的调用: 
int a=1,b=2,c=3,d=0; 
d=MUL(a+b,c) 
经过编译时候展开,就变成了 
d=a+b*c 
而不是我们所希望的 
d=(a+b)*c 
[解决办法] 
其解决办法也很简单,就是给每个分量,都加上括号,就可以避免此类问题 
即,在宏定义的时候,如此定义:

#define MUL(A,B) ((A)*(B))
 
 
  • 1
  1. #define的变体,即#ifndef,可以防止头头文件的重复引用 
    [释] 
    #ifdef和 #define组合,一般用于头文件中,用以实现防止多个文件对此同一个头文件的重复引用.实际使用中,即使你的头文件暂时没有被多个文件所引用,为了增加程序可读性,移植性,健壮性等,还是最好都加上。其用法一般为:
#ifndef <</SPAN>标识>
#define <</SPAN>标识>
………   // include or define sth.
#endif
 
 
  • 1
  • 2
  • 3
  • 4

<标识>在理论上来说可以是自由命名的,但每个头文件的这个“标识”都应该是唯一的;标识的命名规则一般是头文件名全大写,前后加下划线,并把文件名中的“.”也变成下划线, 
如:stdio.h对应的就是:

#ifndef _STDIO_H_
#define _STDIO_H_
………   // include or define sth.
#endif
 
 
  • 1
  • 2
  • 3
  • 4

举个例子

#ifndef CHARDEV_H
#define CHARDEV_H

#include


#define MAJOR_NUM 100

 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

……

……

#endif

例子中的chardev.h中,就用到了

#ifndef CHARDEV_H
#define CHARDEV_H#endif
 
 
  • 1
  • 2
  • 3
  • 4

这样做之后,以后某个文件引用此头文件,就包含了chardev.h文件,而其他文件如果再引用此头文件的话,编译器那么就会判断出来,已经define了CHARDEV_H,已经有其他文件引用了此文件,so,the complier will not include this header file. 就可以发现解决重复引用头文件的问题了.

2. #define的变体,即#ifdef,可以实现加入自己需要的模块(源文件) 
[例子] 
在源文件中加入

#ifdef MYSELF_H
#include "myself.c"
#endif
 
 
  • 1
  • 2
  • 3

可以实现在源文件中加入myself.c的代码,将其实现的功能加进来, 即加入了myself模块 
3. 简单的define定义

#define MAXTIME 1000
 
 
  • 1

一个简单的MAXTIME就定义好了,它代表1000,如果在程序里面写

if(i<MAXTIME){.........}
 
 
  • 1

编译器在处理这个代码之前会对MAXTIME进行处理替换为1000。

这样的定义看起来类似于普通的常量定义CONST,但也有着不同,因为define的定义更像是简单的文本替换,而不是作为一个量来使用,这个问题在下面反映的尤为突出。 
4. define的“函数定义” 
define可以像函数那样接受一些参数,如下

#define max(x,y) (x)>(y)?(x):(y);
 
 
  • 1

这个定义就将返回两个数中较大的那个,看到了吗?因为这个“函数”没有类型检查,就好像一个函数模板似的,当然,它绝对没有模板那么安全就是了。可以作为一个简单的模板来使用而已。

但是这样做的话存在隐患,例子如下:

#define Add(a,b) a+b;
 
 
  • 1

在一般使用的时候是没有问题的,但是如果遇到如:c * Add(a,b) * d的时候就会出现问题,代数式的本意是a+b然后去和c,d相乘,但是因为使用了define(它只是一个简单的替换),所以式子实际上变成了

c*a + b*d
 
 
  • 1

另外举一个例子:

#define pin (int*);
 
 
  • 1
pin a,b;
 
 
  • 1

本意是a和b都是int型指针,但是实际上变成int* a,b; 
a是int型指针,而b是int型变量。 
这是应该使用typedef来代替define,这样a和b就都是int型指针了。 
即:

typedef pin (int *)

pin a,b;
 
 
  • 1
  • 2
  • 3

此时:a和b都是 int*型的。 
所以我们在定义的时候,养成一个良好的习惯,建议所有的层次都要加括号。 
5. 宏的单行定义

#define A(x) T_##x
#define B(x) #@x
#define C(x) #x
 
 
  • 1
  • 2
  • 3

我们假设:x=1,则有:

A(1)------〉T_1
B(1)------〉'1'
C(1)------〉"1"
 
 
  • 1
  • 2
  • 3

6. define的多行定义

define可以替代多行的代码,例如MFC中的宏定义(非常的经典,虽然让人看了恶心)

#define MACRO(arg1, arg2) do { /
/* declarations */ /
stmt1; /
stmt2; /
/* ... */ /
} while(0) /* (no trailing ; ) */
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6

关键是要在每一个换行的时候加上一个”/”

7 .在大规模的开发过程中,特别是跨平台和系统的软件里,define最重要的功能是条件编译。

即:

#ifdef WINDOWS
......
......
#endif
#ifdef LINUX
......
......
#endif
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8

可以在编译的时候通过#define设置编译环境

8. 如何定义宏、取消宏

//定义宏
#define [MacroName] [MacroValue]
//取消宏
#undef [MacroName]
//普通宏
#define PI (3.1415926)

带参数的宏
#define max(a,b) ((a)>(b)? (a),(b))
 
 
  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9

关键是十分容易产生错误,包括机器和人理解上的差异等等。

9. 条件编译

#ifdef XXX…(#else) … #endif
例如
#ifdef DV22_AUX_INPUT
#define AUX_MODE 3 
#else
#define AUY_MODE 3
#endif
#ifndef XXX … (#else) … #endif



*************************************************************************FM:http://blog.youkuaiyun.com/jesons_/article/details/51702149*************************************************************************
<think>好的,用户现在想为STM32 HAL库中的多个模块定义添加注释,解释每个模块的功能或用途。之前已经有过类似的提问,用户可能希望得到更详细的指导,特别是针对具体的模块。需要参考用户提供的引用内容,结合之前的回答,给出一个结构清晰、实用的方法。 首先,用户在上一次的问题中已经了解了如何添加注释的基本步骤,比如定位配置文件、使用正确的注释语法以及注意事项。现在用户的需求更具体,要为每个模块添加功能说明。这意味着需要提供每个常见模块的示例注释,并可能涉及模块之间的依赖关系。 需要检查用户提供的引用内容。引用[1]展示了HAL配置文件中如何通过定义宏来包含头文件,这有助于理解模块启用与头文件的关系。引用[2]提到HAL库的函数,这可能与模块功能相关。引用[3]涉及开发环境配置,可能与实际注释过程关联不大,但可以忽略。 用户希望为多个模块添加注释,比如ADC、CRYP等。需要列举这些模块的典型用途,给出注释示例,同时提醒用户注意模块之间的依赖关系,比如某些模块需要其他模块的支持。此外,用户可能希望注释不仅描述功能,还能指出典型应用场景或配置注意事项,比如ADC需要配置时钟或DMA。 在之前的回答中,已经提到了注释语法规范和关键注意事项,这次需要扩展,提供更多模块的具体例子。同时,用户可能关心如何组织这些注释,保持代码的整洁和可读性,比如使用行内注释或块注释,分组模块等。 需要确保回答结构清晰,分步骤说明,包括定位配置文件、注释规范、模块分类注释示例、依赖关系处理、验证方法等。还要注意用户提到的参考站内引用,但根据问题,用户主要需要的是如何添加注释,而不是配置环境或其他内容。 总结回答结构:先回顾基本步骤,然后给出模块分类和具体注释示例,接着处理依赖关系和注意事项,最后验证方法。同时附上相关问题,帮助用户进一步学习。</think>### STM32 HAL模块定义注释方法(增强版) 根据您对模块功能注释的深度需求,结合HAL库配置文件特性[^1],以下是分步骤实现方案: --- #### **一、模块分类注释规范** ```c //=============== 基础外设 ===============// // ADC模数转换模块(支持12位精度采样,需配置DMA/中断) #define HAL_ADC_MODULE_ENABLED // CRYP硬件加密模块(支持AES/DES算法加速) #define HAL_CRYP_MODULE_ENABLED //=============== 通信接口 ===============// /* CAN总线模块配置说明: * 1. 支持CAN 2.0B协议 * 2. 需要配置波特率参数 * 3. 建议配合HAL_DMA_MODULE_ENABLED使用 */ #define HAL_CAN_MODULE_ENABLED //=============== 存储控制 ===============// // QSPI四线SPI接口(用于外接Flash存储器) #define HAL_QSPI_MODULE_ENABLED ``` --- #### **二、多模块联动注释技巧** ```c // 启用DMA模块(必须与HAL_ADC_MODULE_ENABLED配合使用) #define HAL_DMA_MODULE_ENABLED // 启用ADC模块(需要HAL_DMA_MODULE_ENABLED支持连续采样) #define HAL_ADC_MODULE_ENABLED // 启用CRC校验模块(通常与HAL_FLASH_MODULE_ENABLED搭配使用) #define HAL_CRC_MODULE_ENABLED // 启用Flash编程模块(擦写操作需要CRC校验支持) #define HAL_FLASH_MODULE_ENABLED ``` --- #### **三、功能注释模板库** ```c /* 模块名称:HAL_ADC_MODULE_ENABLED * 主要功能:模拟信号采集 * 典型应用: * - 传感器数据读取 * - 电池电压监测 * 依赖模块:HAL_DMA_MODULE_ENABLED * 配置要求:需设置采样周期和分辨率 */ #define HAL_ADC_MODULE_ENABLED /* 模块名称:HAL_CRYP_MODULE_ENABLED * 硬件加速:AES-128/192/256, DES/TDES * 安全特性:支持ECB/CBC加密模式 * 性能指标:加解密速度可达150MHz * 注意:启用后功耗增加约20mA */ #define HAL_CRYP_MODULE_ENABLED ``` --- #### **四、验证与调试** 1. **编译检查**:通过`#ifdef`预编译指令验证模块是否生效 ```c #ifdef HAL_ADC_MODULE_ENABLED #pragma message("ADC模块已启用") // 编译时输出提示 #endif ``` 2. **功能验证**:使用HAL库对应函数测试模块可用性,如: ```c HAL_ADC_Start(&hadc1); // 测试ADC启动函数[^2] ``` ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值