08 函数指针:可替换行为与回调

C 语言面向对象系列

  1. 总纲:C 语言面向对象设计概览
  2. 封装:结构体与多实例接口
  3. 信息隐藏:公共接口与内部实现
  4. 模块组织:命名约定与对象生命周期
  5. 数据组织:实例状态、模块状态与常量
  6. HAL 实例:STM32 外设接口中的封装设计
  7. 结构体嵌套:公共数据与行为的复用
  8. 函数指针:可替换行为与回调(当前篇)
  9. 操作表:使用 ops 组织对象接口
  10. 多态:统一接口、行为分发与类型转换
  11. 接口约定:必选操作、可选操作与默认实现
  12. 框架整合:应用、驱动与平台的分层
  13. 工程扩展:自动注册与 Linux 内核中的对象组织

上一节通过 base 复用了公共数据,但不同 LED 仍需要不同的操作。GPIO LED 设置电平,PWM LED 设置占空比,RGB LED 可能同时控制多个通道。

本节先学习函数指针:保存一个函数的地址,再通过这个指针调用函数。

将固定调用改为可传入的操作

下面的函数每次都调用 led_base_on():

1
2
3
4
void led_run_once(LedBase_t *led)
{
led_base_on(led);
}

如果还需要执行关闭、翻转或闪烁,可以让调用方传入要执行的函数。这样执行流程可以复用,具体操作由参数决定。

先看下面三个函数,它们的参数类型和返回值类型相同:

1
2
3
int led_base_on(LedBase_t *me);
int led_base_off(LedBase_t *me);
int led_base_toggle(LedBase_t *me);

它们都接收 LedBase_t *,返回 int。对应的函数指针类型可以用 typedef 命名:

1
typedef int (*LedAction_t)(LedBase_t *me);

LedAction_t 表示一个函数指针类型。理解这个声明时,可以先看参数 LedBase_t *me 和返回类型 int,再看中间的 (*LedAction_t),它说明保存的是函数指针。

接收并调用函数指针

通用执行函数接收两个参数:要操作的对象,以及要调用的函数:

1
2
3
4
5
6
7
8
9
10
11
12
int led_run_action(LedBase_t *me, LedAction_t action)
{
if (me == NULL) {
return -1;
}

if (action == NULL) {
return -2;
}

return action(me);
}

检查指针后,action(me) 就会调用传入的函数,并将 me 作为参数传给它。

调用方可以选择不同操作:

1
2
3
led_run_action(&red.base, led_base_on);
led_run_action(&red.base, led_base_off);
led_run_action(&red.base, led_base_toggle);

注意传入函数与直接调用函数的区别:

表达式 含义
led_base_on 在这里的赋值或传参表达式中,转换为函数指针
led_base_on(&red.base) 立即调用函数
LedAction_t action = led_base_on; 保存函数指针
action(&red.base); 通过保存的指针调用函数

因此,给 led_run_action() 传入的是 led_base_on,不是执行 led_base_on() 后得到的返回值。

在运行时选择操作

函数指针也可以根据当前模式赋值:

1
2
3
4
5
6
7
8
9
10
11
LedAction_t action = NULL;

if (mode == 0) {
action = led_base_on;
} else if (mode == 1) {
action = led_base_off;
} else {
action = led_base_toggle;
}

led_run_action(&red.base, action);

这里先根据 mode 选择操作,再通过同一个 led_run_action() 执行。调用哪个函数可以在运行时确定,执行入口保持不变。

用回调连接按键和 LED

回调是函数指针的一种常见用法:调用方先提供函数,模块在约定的时机调用它。

例如,按钮模块只负责扫描输入,不需要直接调用 LED 接口。它可以保存一个回调和一份用户数据指针:

1
2
3
4
5
6
7
typedef void (*ButtonCallback_t)(void *context);

typedef struct {
uint8_t pin;
ButtonCallback_t on_pressed;
void *context;
} Button_t;

on_pressed 保存函数指针,context 保存调用这个函数时要传入的数据。初始化时记录这两个参数,扫描时再使用:

1
2
3
4
5
6
7
8
9
10
void button_scan(Button_t *me)
{
if (me == NULL) {
return;
}

if (gpio_read(me->pin) && me->on_pressed != NULL) {
me->on_pressed(me->context);
}
}

这段简化代码只演示回调过程。输入保持有效电平时,每次扫描都会调用回调,尚未包含消抖或按下沿检测。

业务层提供回调,将用户数据转换为 LED 对象指针,再执行翻转:

1
2
3
4
5
6
7
static void user_led_toggle(void *context)
{
LedBase_t *led = (LedBase_t *)context;
led_base_toggle(led);
}

button_init(&button, 1, user_led_toggle, &led);

这里的 led 应是 LedBase_t 对象,&led 会作为 context 传给回调。这样按钮模块只依赖回调约定,LED 模块也无需了解按钮模块;两者之间的配合由业务层建立。

函数指针的使用约束

函数指针能够替换操作,但调用条件仍需要明确:

需要检查的内容 处理方式
函数指针是否为空 调用前检查 NULL
参数和返回值类型是否匹配 用 typedef 统一函数指针类型
context 的实际类型 由接口约定,回调按约定转换
回调的执行环境 明确是在普通流程、定时器还是中断中执行

尤其在中断中,回调应尽量简短,是否允许阻塞需要由执行环境决定。函数指针只负责选择函数,不会自动处理这些约束。

按键、定时器、通信协议、驱动适配和状态机都可以采用回调。C++ 中也常通过 std::function 或 lambda 组织回调;本例使用函数指针和 context 表达所需关系。

下一篇将多个相关的函数指针放进操作表,让一个对象绑定一整组操作。