前言
在 HAL 库中,很多回调函数前面使用__weak 修饰符。
weak 顾名思义是“弱”的意思,所以如果函数名称前面加上__weak 修饰符,我们一般称这个函数为“弱函数”。
加上了__weak 修饰符的函数,用户可以在用户文件中重新定义一个同名函数,最终编译器编译的时候,会选择用户定义的函数,如果用户没有重新定义这个函数,
那么编译器就会执行__weak 声明的函数,并且编译器不会报错。
举个例子
我们打开工程模板,找到并打开文件stm32f4xx_hal.c 文件,里面定义了一个函数 HAL_MspInit,定义如下:
__weak void HAL_MspInit(void)
{
__IO uint32_t tmpreg = 0x00;
UNUSED(tmpreg);
}
可以看出,HAL_MspInit 函数前面有加修饰符__weak。同时,在该文件的前面有定义函数HAL_Init,并且 HAL_Init 函数中调用了函数 HAL_MspInit。
HAL_StatusTypeDef HAL_Init(void)
{
…//此处省略部分代码
HAL_MspInit();
return HAL_OK;
}
如果我们没有在工程中其他地方重新定义 HAL_MspInit()函数,那么 HAL_Init 初始化函数执行的时候,会默认执行 stm32f4xx_hal.c 文件中定义的 HAL_MspInit 函数,而这个函数没有任何控制逻辑。 如果用户在工程中重新定义函数 HAL_MspInit,那么调用 HAL_Init 之后,会执行用户自己定义的 HAL_MspInit 函数而不会执行 stm32f4xx_hal.c 默认定义的函数。也就是说,表面上我们看到函数 HAL_MspInit 被定义了两次,但是因为有一次定义是弱函数,使用了__weak修饰符,所以编译器不会报错。
总结
__weak 在回调函数的时候经常用到。这样的好处是,系统默认定义了一个空的回调函数,保证编译器不会报错。同时,如果用户自己要定义用户回调函数,那么只需要重新定义即可,不需要考虑函数重复定义的问题,使用非常方便,在 HAL 库中__weak 关键字被广泛使用。
应用
创建一个工程如下:
在weakTest.c中定义一个weak函数,并且定义一个调用该weak函数的函数
__weak void weakFunctioin(void){ //定义为__weak类型的函数
logInfo("print weakFunction\r\n");
} int weakFunctionTest(unsigned int tst){ logInfo("print A\r\n");
if (tst) {
logInfo("print B\r\n");
weakFunctioin(); //调用函数
logInfo("print C\r\n");
}else{
logInfo("print D\r\n");
}
logInfo("print E\r\n");
return ;
}
在main.c文件中,定义main函数及weakFunctionTest函数:
void weakFunctioin(void){ //定义为正常的函数 logInfo("print nonWeakFunction\r\n");
return;
} int main(void){ logInit(logLevelDebug);
logInfo("Build @ %s %s,system start\r\n", __DATE__, __TIME__); weakFunctionTest();
logInfo("Build @ %s %s,system stop\r\n", __DATE__, __TIME__);
while();
return ;
}
运行时打印为:
-I: Build @ Jun ::,system start
-I: print A
-I: print B
-I: print nonWeakFunction
-I: print C
-I: print E
-I: Build @ Jun ::,system stop
参考:
https://blog.csdn.net/baicaiaichibaicai/article/details/73129417?utm_source=blogxgwz1
https://blog.csdn.net/qq562029186/article/details/76216311#