STM32函数库Assert断言机制

看到交流群的小伙伴正在讨论STM32标准库中的Assert断言语句，我察觉到很多人对Assert的概念并不清楚。因此，我想再次分享一些关于Assert的知识。

1 引言

懂行的工程师都清楚，随着软件版本的升级或需求的变更，我们的代码会越来越庞大。然而，在编码过程中，如果没有注重一些细节，你的代码可能会隐藏着很多错误。

那么，我们如何找出这些隐藏的错误呢？

今天，我将介绍其中一个方法：Assert断言。

2 Assert断言的概述

那么，什么是Assert断言呢？

当我们编写代码时，我们通常会做一些假设。而Assert断言就是用来捕捉这些假设的，可以将其视为异常处理的一种高级形式。

断言是一种布尔表达式，程序员在代码的特定位置相信该表达式的值为真。

断言的验证可以在任何时候启用或禁用，这使得我们能够在测试时启用断言，在部署时禁用断言。

同样地，当最终用户遇到问题时，他们也可以重新启用断言来进行调试。

这里的概念，可能不好理解，简单举一个例子来说明吧。

有这么一个数组和函数：

int Array[5] = {0xA1, 0xB2, 0xC3, 0xD4, 0xE5};

int Fun(char i)
{
    return Array[i];
}

如果我们函数中不加Assert断言语句，你觉得直接调用会这个函数会有风险吗？

假如这么调用：

int a;
a = Fun(8);

很明显，就这么调用，会出错，且我们不容易发现错误在哪里。

但是，假如添加有Assert断言语句，错误就能一下找出来。

3Assert断言实际应用

其实，Assert断言在很多标准的代码中，基本都有。我们还是拿STM32的代码来说明吧。

不管是STM32标准外设库、还是HAL、LL库源代码里面都有Assert断言机制。

不知道大家有没有注意过assert_param函数？

1.拿STM32最常见的GPIO初始化函数为例

A.标准外设库GPIO初始化：

B.HAL库GPIO初始化：

相信大家都看到过STM32库中的参数断言语句，他的作用就是用于检查函数传入参数是否正确。

2.STM32参数断言使能

STM32的assert_param参数断言函数是没有使能的，如下：

#define assert_param(expr) ((void)0)

也就是assert_param不起作用。

如果需要使用，就需要对其使能才行。

A.标准外设库

B.HAL库

道理一样，使能ASSERT，可以手动：

#define USE_FULL_ASSERT    1U

也可以通过STM32CubeMX配置：

3.代码大小

添加Assert断言之后，代码量肯定要增加，比如：

不使能assert_param代码量：

Code=5350 RO-data=360 RW-data=16 ZI-data=1152

使能assert_param：

Code=8300 RO-data=362 RW-data=16 ZI-data=1152

4.断言失败处理

断言失败，可根据实际项目需求，做出一定处理。比如：打印错误信息，存储错误日志等。

本文就讲到这里，方法教给大家，需要自己理解并消化其中内容。

以上就是良许教程网为各位朋友分享的Linu系统相关内容。想要了解更多Linux相关知识记得关注公众号“良许Linux”，或扫描下方二维码进行关注，更多干货等着你 ！