assert_param

最新推荐文章于 2025-03-19 09:30:13 发布
原创 最新推荐文章于 2025-03-19 09:30:13 发布 · 5.3k 阅读 · 16 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文深入探讨了STM32库函数中assert_param宏的作用及其条件判断机制。当参数有效时，assert_param不执行任何操作；若参数无效，则调用assert_failed函数并输出错误信息，包括错误发生的文件名和行号。

       在STM32的库函数中，好多函数都有"assert_param()"这个断言。这个宏作用是检查输入的参数是否有效，若非有效参数则输出某个警告。

"assert_param"的定义如下：

       当"USE_FULL_ASSERT"这个宏未定义时，assert_param就是一个空的宏，没有任何操作。定义"USE_FULL_ASSERT"时，当参数"expr"为真时，则无操作（（void）0）;当参数"expr"为假时，则调用函数 assert_failed()；但库函数中，只对assert_failed()进行了声明，具体功能并未实现，我们可以根据自己的需求进行封装。assert_failed()函数有两个输入参数，

__FILE__及 __LINE__；分别表示宏被调用时所在的“文件名”及“行号”。例如，我们可以使用printf()输出这些信息。

 

 

STM32中HAL库函数的断言函数assert_param()用法解析
weixin_41163322的博客
05-16 2624
assert_param()的作用 assert_param是一个宏定义，在程序开发中，它的作用就是检测传递给函数的参数是否是有效的参数。默认是不开启的，可以无视它的存在，但在调试程序时，可以打开这个检测机制，调试完再关闭。 assert_param()的函数原型 从库函数源码可以看出，assert_param()的函数功能默认是不开启的，取消 #define USE_FULL_ASSERT 1U 的注释，可以开启该功能。 /* ########################## Asser
STM32断言机制 assert_param（expr）
weixin_43583173的博客
04-19 1274
> [STM32库函数 断言机制](https://blog.youkuaiyun.com/weixin_30783913/article/details/97636889?depth_1-utm_source=distribute.pc_relevant_right.none-task-blog-BlogCommendFromMachineLearnPai2-4&utm_source=distribute.pc_relevant_right.none-task-blog-BlogCommendFromMachineL
如何使用assert_param
08-03
本文介绍了一种使用软件调试stm32的高效率的方法。
STM32 中的 assert_param 函数
热门推荐
chuckfql的专栏
06-16 4万+
我们在学STM32的时候函数assert_param出现的几率非常大，上网搜索一下，网上一般解释断言机制，做为程序开发调试阶段时使用。下面我就谈一下我对这些应用的看法，学习东西抱着知其然也要知其所以然。 4 断言机制函数assert_param 我们在分析库函数的时候，几乎每一个函数的原型有这个函数assert_param()；下面以assert_param(IS_GPIO_ALL_PERIP
STM32中assert_param的使用
Super_Demo的专栏
01-04 3042
 我们在学STM32的时候函数assert_param出现的几率非常大，上网搜索一下，网上一般解释断言机制，做为程序开发调试阶段时使用。下面我就谈一下我对这些应用的看法，学习东西抱着知其然也要知其所以然。 在STM32的固件库和提供的例程中，到处都可以见到assert_param()的使用。如果打开任何一个例程中的stm32f10x_conf.h文件，就可以看到实际上a
函数：assert_param()
qq_47827276的博客
03-19 579
判断参数expr是否为真，为真执行语句(void)0，为假就执行后面的函数assert_failed((uint8_t *)__FILE__,__LINE__)，函数的作用在库函数中有解释，用来指示出错的行数和文件。2、#define为预处理指令，在编译预处理时，对程序中所有出现的“宏名”，都用宏定义中的字符串去代换，这称为“宏代换”或“宏展开”，因此可以指出出错的行数与文件。在程序的运行上牺牲了效率(但只是在调试阶段)，但在项目的开发上却帮助你提高了效率。
关于assert_param的疑惑
07-20
### 关于assert_param的理解与应用 #### 一、assert_param简介 `assert_param`是一个用于检查函数参数有效性的宏，在调试阶段特别有用。它只在`DEBUG`模式下生效，这意味着在发布版本（非调试版本）中，这些检查将...
c语言assert_param,STM32断言机制assert_param()宏定义
weixin_33657398的博客
05-24 970
我们在学STM32的时候函数assert_param出现的几率非常大，上网搜索一下，网上一般解释断言机制，做为程序开发调试阶段时使用。下面我就谈一下我对这些应用的看法，学习东西抱着知其然也要知其所以然。我们在分析库函数的时候，几乎每一个函数的原型有这个函数assert_param()；下面以assert_param(IS_GPIO_ALL_PERIPH(GPIOx));为例说一下我的理解，函数的参...
assert_param-转载.txt
12-12
### assert_param 在 STM32 中的应用 #### 一、assert_param 概述 在 STM32 开发过程中，为了确保程序的稳定性和可靠性，经常需要使用到断言（assert）来验证函数参数的有效性。`assert_param` 是一个用于参数验证...
assert_param()
whxngb的博客
12-31 477
在STM32的固件库和提供的例程中，到处都可以见到assert_param()的使用。如果打开任何一个例程中的stm32f10x_conf.h文件，就可以看到实际上assert_param是一个宏定义； 在固件库中，它的作用就是检测传递给函数的参数是否是有效的参数。 所谓有效的参数是指满足规定范围的参数，比如某个参数的取值范围只能是小于3的正整数，如果给出的参数大于3， 则这个assert_
stm32中assert_param函数
grey911的博客
02-15 441
assert_param意为:参数的确定 作用:判断传递给函数的参数是否有效 assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); #define IS_GPIO_ALL_PERIPH(PERIPH) (((PERIPH) == GPIOA) || \ ((PERIPH) == GPIOB)...
STM32固件库 assert_param函数
cyang's blog
10-24 1351
本文同步至个人博客:cyang.tech 一、知识点 -1、固件函数库通过检查库函书的输入来实现运行时间错误侦测。通过使用宏assert_param来实现运行时间检测。所有要求输入参数的函数都使用这个宏。它可以检查输入参数是否在允许的范围之内。 例如通过定义 #define IS_ADC_ALL_PERIPH(PERIPH) (((PERIPH) == ADC1) || \ ...
assert_param函数的用法
weifeng blog
09-14 453
assert_param函数的用法：https://www.cnblogs.com/leo0621/p/9435794.html
assert_param()的使用
二进制模----细微行动改变影响世界
10-21 763
assert_param()的使用 zhj失落之地 2018-01-10 21:23:12 1196 收藏 5 分类专栏： stm32相关 最后发布:2018-01-10 21:23:12首次发布:2018-01-10 21:23:12 版权声明：本文为博主原创文章，遵循CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。 本文链接：https://blog.youkuaiyun.com/u013216061/article/details/79028425 版权 在STM32的
assert_param函数笔记
fila_w的博客
07-21 1278
在STM32的固件库和提供的例程中，经常可以看到assert_param函数的身影，实际上assert_param是一个宏定义； 在固件库中，它的作用就是检测传递给函数的参数是否是有效的参数。 例如： assert_param(IS_GPIO_ALL_PERIPH(GPIOx)); 这句语句是位于gpio.c文件里的GPIO_ReadInputDataBit 数中，其中assert_param的传入参数是一个宏： 宏定义的功能是参数GPIOx是GPIOA~GPIOK其中的一个，表示参数GPIOx有效，返回
Stm32中的assert_param()函数
limanjihe的专栏
04-16 1089
reference:http://blog.sina.com.cn/s/blog_dc9571b90102vhuw.html 大家在用stm32库函数的时候几乎都会发现assert_param()这个函数，这个函数是判断参数有没有错误，具体是什么错误呢，我会在后面贴图的。 assert_param()这个函数在stm32f10x_conf.h中定义： #ifdef US...
assert_param作用
最新发布
09-12
<think> 我们正在讨论的是STM32固件库中的assert_param宏。根据引用内容，它的主要作用是在函数调用时检查传入的参数是否有效。如果启用了USE_FULL_ASSERT，并且参数无效（即expr为假），则调用assert_failed函数报告错误（包括文件名和行号）；如果没有启用，则assert_param(expr)被定义为((void)0)，即不产生任何效果。 具体来说，assert_param的使用是为了在开发调试阶段帮助程序员及时发现参数错误，避免因参数错误导致程序运行异常。在正式发布时，可以通过不定义USE_FULL_ASSERT来关闭这个检查，以减少代码大小和运行开销。 从引用中我们可以看到，assert_param宏的定义如下： 当定义了USE_FULL_ASSERT时： #define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t *)__FILE__, __LINE__)) 否则： #define assert_param(expr) ((void)0) 在固件库的函数中，通常会先使用assert_param来检查参数，然后再执行函数体。例如在ADC_Cmd函数中，使用assert_param检查ADCx是否为有效的外设以及NewState是否为有效的功能状态（DISABLE或ENABLE）。 因此，assert_param的作用总结如下： 1. 参数有效性检查：确保传递给函数的参数在允许的取值范围内。 2. 调试辅助：当参数无效时，会触发错误报告（调用assert_failed函数），通常这个函数会提供错误位置（文件名和行号）的信息，方便调试。 3. 可配置：通过是否定义USE_FULL_ASSERT宏，可以开启或关闭参数检查功能。在调试阶段开启，在发布阶段关闭，以平衡调试需求和运行效率。 注意：assert_failed函数需要用户自己实现，通常在一个名为main.h或类似的文件中声明，然后在main.c中实现。例如： void assert_failed(uint8_t* file, uint32_t line) { printf("Assert failed in file %s at line %d\n", file, line); while(1); } 下面我们按照要求整理回答： </think> ### `assert_param`的作用详解 `assert_param`是STM32固件库中用于参数校验的宏定义，其主要作用如下： #### 1. **参数有效性验证** - **运行时检查**：在函数执行时实时检测传入参数的有效性 - **范围验证**：确保参数在预设的有效范围内（例如：检查外设地址是否正确） - **错误拦截**：当检测到无效参数时立即触发错误处理机制 ```c void ADC_Cmd(ADC_TypeDef* ADCx, FunctionalState NewState) { /* 参数检查 */ assert_param(IS_ADC_ALL_PERIPH(ADCx)); // 验证ADC外设地址有效性[^3] assert_param(IS_FUNCTIONAL_STATE(NewState)); // 验证状态值有效性 ... } ``` #### 2. **调试辅助机制** - **错误定位**：通过`__FILE__`和`__LINE__`宏精确报告错误位置[^2] - **可配置性**：通过`USE_FULL_ASSERT`宏控制启用/禁用 ```c #ifdef USE_FULL_ASSERT #define assert_param(expr) ((expr) ? (void)0 : assert_failed((uint8_t*)__FILE__, __LINE__)) #else #define assert_param(expr) ((void)0) // 正式发布时禁用 #endif ``` #### 3. **错误处理机制** - **失败回调**：触发无效参数时调用`assert_failed()`函数 - **用户自定义**：开发者需自行实现错误处理逻辑（如日志记录或系统复位） ```c void assert_failed(uint8_t* file, uint32_t line) { printf("Assert失败: %s文件第%lu行", file, line); while(1); // 死循环防止继续执行 } ``` #### 4. **开发阶段优势** - **早期发现问题**：在编码阶段捕获参数错误（如外设标识符错误）[^4] - **减少调试成本**：避免因参数错误导致的异常行为调试难题 - **代码健壮性**：强制规范API使用方式（如时钟配置函数中的正确参数）[^5] #### 实际工作流程 ```mermaid graph TD A[函数调用] --> B{参数是否有效?} B -->|有效| C[正常执行] B -->|无效| D[触发assert_failed] D --> E[报告文件名/行号] E --> F[执行用户定义错误处理] ```
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值