电力电子技术
直播中

张国厚

8年用户 1472经验值
私信 关注
[问答]

关于Assert_param的学习笔记分享,不看肯定后悔

关于Assert_param的学习笔记分享,不看肯定后悔

回帖(1)

王燕

2021-6-10 16:25:42
   在STM32的固件库和提供的例程中,到处都可以见到assert_param()的使用。比如下面的库函数:void GPIO_SetBits(GPIO_TypeDef* GPIOx,uint16_t GPIO_Pin){/* Check the parameters */assert_param(IS_GPIO_ALL_PERIPH(GPIOx));assert_param(IS_GPIO_PIN(GPIO_Pin));GPIOx->BSRR = GPIO_Pin;}在头文件stm32f10x_GPIO.h, 定义了宏:
    #define IS_GPIO_ALL_PERIPH(PERIPH)(((PERIPH) == GPIOA) || /                                   ((PERIPH)== GPIOB) || /                                   
    ((PERIPH)== GPIOC) || /                                   
    ((PERIPH)== GPIOD) || /                                   
    ((PERIPH)== GPIOF))
     就可以看到实际上assert_param是一个宏定义,它的作用就是检测传递给函数的参数是否是有效的参数。所谓有效的参数是指满足规定范围的参数,比如某个参数的取值范围只能是GPIOA,GPIOB, GPIOC,GPIOD,GPIOF这5个,如果给出的参数不在这个范围,
    则这个assert_param()可以在运行的程序调用到这个函数时报告错误,使程序员可以及时发现错误,而不必等到程序运行结果的错误而大费周折。
    这是一种常见的软件技术,可以在调试阶段帮助程序员快速地排除那些明显的错误。它确实在程序的运行上牺牲了效率(但只是在调试阶段),但在项目的开发上却帮助你提高了效率。
    当你的项目开发成功,使用release模式编译之后,或在stm32f10x_gpio.h文件中注释掉宏定义,所有的assert_param()检验都消失了,不会影响最终程序的运行效率。
    你可以按照自己使用的环境需求,添加适当的语句输出错误的信息提示,或修改这个函数做出适当的错误处理。如果发现参数出错,它会调用函数assert_failed()向程序员报告错误,在任何一个例程中的main.c中都有这个函数的模板,如下:void assert_failed(uint8_t* file,uint32_t line)
    {while (1){}}
    你可以按照自己使用的环境需求,添加适当的语句输出错误的信息提示,或修改这个函数做出适当的错误处理。
举报

更多回帖

发帖
×
20
完善资料,
赚取积分