STM32的hal库中__weak函数前缀的作用

Posted 2023-03-15

参考技术A 在使用STM32的hal库的时候，我们常常可以看到很多库自带的函数有很多是使用__weak修饰的，比如：

weak 顾名思义是“弱”的意思，所以如果函数名称前面加上__weak 修饰符，我们一般称这个函数为 “弱函数” 。

加上了__weak 修饰符的函数，用户可以在用户文件中重新定义一个同名函数，最终编译器编译的时候，会选择用户定义的函数，如果用户没有重新定义这个函数，那么编译器就会执行__weak 声明的函数，并且编译器不会报错。

__weak是一个宏，和__packed是同一种东西都是gcc的扩展属性：

#define __packed __attribute__((packed))

#define __weak __attribute__((weak))

如果这个关键字用在函数定义上面，一般情况下和一般函数没有两样。但是当有一个同名函数但是不带__weak被定义时，所有对这个函数的调用都是指向后者(不带__weak那个), 如果有两个一样的函数都用了__weak,那么真正调用那个，就要看连接器了。

例子：

我们打开一个工程

可以看出，HAL_CAN_TxCpltCallback 函数前面有加修饰符__weak。同时，并且 CAN_Transmit_IT函数中调用了函数 HAL_CAN_TxCpltCallback。

如果我们没有在工程中其他地方重新定义 HAL_CAN_TxCpltCallback ()函数，那么 CAN_Transmit_IT初始化函数执行的时候，会默认执行 stm32f0xx_hal_can.c 文件中定义的 HAL_CAN_TxCpltCallback 函数，而这个函数没有任何控制逻辑。

如果用户在工程中重新定义函数 HAL_CAN_TxCpltCallback ，那么调用 CAN_Transmit_IT之后，会执行用户自己定义的HAL_CAN_TxCpltCallback 函数而不会执行 stm32f0xx_hal_can.c 默认定义的函数。也就是说，表面上我们看到函数 HAL_CAN_TxCpltCallback 被定义了两次，但是因为有一次定义是弱函数，使用了__weak修饰符，所以编译器不会报错。

愿你出走半生，归来仍是少年…