回调函数和表驱动法编程

Posted regressionworldline

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了回调函数和表驱动法编程相关的知识,希望对你有一定的参考价值。

回调函数和表驱动法编程

回调函数

回调函数其实就是在一个函数里面调用了另一个函数,而调用哪个函数是由调用回调函数的人决定,举个简单例子:

int add(int a,int b)
{
    return a+b;
}
int sub(int a,int b)
{
    return a-b;
}
typedef int (*pfunc)(int a,int b);
int func_callback(pfunc p,int a,int b)
{
	return(*p)(a,b);
}
void main(void)
{
    func_callback(add,1,2);//return 3
    func_callback(sub,2,1);//return 1
}

这里的func_callback就是回调函数,它的执行结果根据传进来的函数指针p的实际指向函数不同而不同,即传入加法add得到的是加法计算,传入减法sub得到的是减法计算结果。

回调函数的使用使得上层调用时仅需要同一个接口(func_callback)即可,而根据传入的参数不同而调用到不同的底层结果。

例如add和sub是操作系统或BSP提供的一个功能。我们希望上层应用在调用时具有拓展性,即如果底层新增了新的功能例如乘除法(mul,div),我们无需修改上层应用的接口,仅需在传入参数时增加新的参数(mul,div)即可。这样底层提供的API具有了通用性,应用层无需修改调用api的接口即可增加新的使用方式。

回调函数还有一个很好用的功能是和表驱动法结合:

表驱动法

表驱动法顾名思义就是类似数据库查表的方式实现功能,简单地说,将程序中的分支判断变为查表操作,简单例子:

char getCharfromHex(unsigned char ucNum)
{
    char ucNumChar = 0;
    if(ucNum < 10)
    {
        ucNumChar = ucNum + ‘0‘;
    }
    else if(ucNum == 10)
    {
        ucNumChar = ‘A‘;
    }
    else if(ucNum == 11)
    {
        ucNumChar = ‘B‘;
    }
    else if(ucNum == 12)
    {
        ucNumChar = ‘C‘;
    }
    else if(ucNum == 13)
    {
        ucNumChar = ‘D‘;
    }
    else if(ucNum == 14)
    {
        ucNumChar = ‘E‘;
    }
    else if(ucNum == 15)
    {
        ucNumChar = ‘F‘;
    }
    else
    {
    	return 0;    
    }
    return ucNumChar;
}

上面的操作是将一个16进制数变为ASCII表示的字符,如果使用表驱动,则可以实现为:

CHAR aNumChars[] = {‘0‘, ‘1‘, ‘2‘, /*3~9*/‘A‘, ‘B‘, ‘C‘, ‘D‘, ‘E‘, ‘F‘};
CHAR ucNumChar = aNumChars[ucNum % sizeof(aNumChars)];

这样一个较多的if else或者switch case语句变为简单的查表操作。

使用表驱动法,则可以将很多功能接口进行排列后按查表方式进行执行,当功能接口较多时能够比switch语句更加简洁。

由表驱动和回调函数组成的通用功能接口

首先将对外的功能进行一个排列,构造一个功能接口表,并对功能接口编码(dispatch.h):

typedef enum {
	ChipCheck = 0x41,
	DataTrans = 0x01,
	/*others*/
	DataSave = 0x77,
} FunctionCode_t;

根据功能函数的格式,声明一个函数指针(dispatch.h):

typedef u32 (*pFunc)(u8 *cmd_in, u8 *cmd_out);

实现功能函数,注意功能函数的接口尽量保持一致,可以通过传入一个通用的结构体或指针数组方式,具体功能处理上的区别接口内部对数据进行细分处理。

头文件(dispatch.h):

u32 func_ChipCheck(u8 *cmd_in, u8 *cmd_out);
u32 func_DataTrans(u8 *cmd_in, u8 *cmd_out);
u32 func_DataSave(u8 *cmd_in, u8 *cmd_out);

源文件(dispatch.c):

u32 func_ChipCheck(u8 *cmd_in, u8 *cmd_out)
{
	/*do something*/
	PRINT_WARN("func %s,line num: %d, %p,%d!
", __FUNCTION__, __LINE__, cmd_in, 2);
	return (0);
}

u32 func_DataTrans(u8 *cmd_in, u8 *cmd_out)
{
	/*do something*/
	PRINT_WARN("func %s,line num: %d, %p,%d!
", __FUNCTION__, __LINE__, cmd_in, 2);
	return (0);
}
u32 func_DataSave(u8 *cmd_in, u8 *cmd_out)
{
	/*do something*/
	PRINT_WARN("func %s,line num: %d, %p,%d!
", __FUNCTION__, __LINE__, cmd_in, 2);
	return (0);
}

建立索引关系,即functionlist中的功能接口和funcCodelist的接口名称一一对应起来,同时编写索引查找函数。在源文件进行定义:

pFunc functionlist[] = {
	func_ChipCheck,
	func_DataTrans,
	func_DataSave,
};

u8 funcCodelist[] =
{
	ChipCheck,
	DataTrans,
	DataSave,
};
/**
 * 功能接口的回调函数
 *
 * @author KingBoy (2020/5/24)
 *
 * @param p 被调用的函数
 * @param cmd_in 输入参数
 * @param cmd_out 输出参数
 *
 * @return u32 0-success
 */
u32 dispath_callback(pFunc p, u8 *cmd_in, u8 *cmd_out)
{
	u32 ret = 0;
	ret = (*p)(cmd_in, cmd_out);
	return (ret);
}
/**
 * 功能派发接口
 *
 * @author KingBoy (2020/5/23)
 *
 * @param cmd_ptr 输入输出:数据起始地址
 * @param cmd_len 输入输出:数据长度
 */
void function_dispatch(u8 *cmd_ptr, u32 *cmd_len)
{
	int func_code;

	func_code = getEnumIndex(*(cmd_ptr));
	PRINT_WARN("func %s,line num: %d, %02x
", __FUNCTION__, __LINE__, func_code);
	if (func_code != -1)
	{
		//用法1,直接定义函数数组后调用
		//functionlist[func_code](cmd_ptr, cmd_ptr);
		//用法2,使用回调函数进行处理
		dispath_callback(functionlist[func_code], cmd_ptr, cmd_ptr);
	}
	else
	{
		PRINT_WARN("func %s,line num: %d, %02x
", __FUNCTION__, __LINE__, func_code);
	}
}
/**
 * 获取功能的索引位置
 *
 * @author KingBoy (2020/5/23)
 *
 * @param value 功能码值
 *
 * @return int 索引位置,-1为未找到
 */
int getEnumIndex(u8 value)
{
	int i = 0;
	for (i = 0; i < sizeof(funcCodelist); i++)
	{
		if (value == funcCodelist[i])
		{
			return (i);
		}
	}
	if (i >= sizeof(funcCodelist))
	{
		return (ERR_NOFUNC);
	}

	return (0);
}

function_dispatch即处理的函数,cmd_ptr将外部数据传入,根据第一个字节的取值决定是执行哪个功能函数(*(cmd_ptr)),在getEnumIndex中获得该功能的索引位置,如果查到的位置合法(不是-1),则调用回调函数dispath_callback并将需要调用的功能函数functionlist[func_code]传入,同时传入函数的参数(u8 *cmd_in, u8 *cmd_out)。

对于相似的功能接口来说,可以选择直接调用(functionlist[func_code](cmd_ptr, cmd_ptr);)或者是回调函数调用(dispath_callback(functionlist[func_code], cmd_ptr, cmd_ptr);)两者的处理等价。

如果使用回调函数,当想要修改功能时,可以只在dispath_callback进行操作而不需要对底层进行修改。

以上是关于回调函数和表驱动法编程的主要内容,如果未能解决你的问题,请参考以下文章

C语言精华知识:表驱动法编程实践

C语言表驱动法编程实践(精华帖,建议收藏并实践)

什么是回调函数?

数据驱动编程与表驱动法(多if-else结构精简)

数据驱动编程与表驱动法(多if-else结构精简)

实验二:事件驱动-回调函数实现爬虫