如何让 Source Insight 识别 AUTOSAR 宏定义 FUNC

有很多从事汽车电子行业的软件工程师在使用Source Insight阅览Classic AUTOSAR协议栈源码的时候，

发现函数名无法解析，基本上都变成了FUNC。

• 先说原因：

AUTOSAR的协议栈为了实现多平台和编译器兼容，大量使用宏定义来代替关键字。

函数，指针，返回值，等等。这样可以实现代码对编译器的解耦和复用。

这种标准或者平台化设计的代码，真的和目标就是一亩三分地开发的模式不一样。为了可扩展和复用解耦，增加了很多设计。

• 解决方法：

Source Insight在 C:\Users\你的用户名\Documents\Source Insight 4.0下面有一个C.tom。在里面可以自定义一些宏展开，

让Source Insight解析，在分析符号的时候进行替换。

注意：目前发现好像不支持宏的嵌套使用，也就是说不可避免的，有一些嵌套使用的宏定义会解析错误。常见于指针的使用解析。

比如FUNC里传入参数是个用宏描述的常量指针，就会被误识别。

宏定义的来源一般放在各种文件名带"compiler"的头文件下，搜索“#define FUNC”这样的字符串差不多就可以搜索到。

例如：

#define FUNC(rettype, memclass) rettype
 
#define FUNC_P2CONST(rettype, ptrclass, memclass) const rettype *
 
#define FUNC_P2VAR(rettype, ptrclass, memclass) rettype *
 
#define P2VAR(ptrtype, memclass, ptrclass)     ptrtype *
 
#define P2CONST(ptrtype, memclass, ptrclass)  const ptrtype *
 
#define CONSTP2VAR(ptrtype, memclass, ptrclass) ptrtype * const
 
#define CONSTP2CONST(ptrtype, memclass, ptrclass) const ptrtype * const
 
#define P2FUNC(rettype, ptrclass, fctname) rettype (* fctname)
 
#define CONSTP2FUNC(rettype, ptrclass, fctname) rettype (* const fctname)
 
#define CONST(consttype, memclass) const consttype
 
#define VAR(vartype, memclass) vartype
 
#define P2P2VAR(ptrtype, memclass, ptrclass) ptrtype **

这样只需要在C.tom末尾添加上述内容，去掉前面的#define就可以了

例如：

FUNC(rettype, memclass) rettype
FUNC_P2CONST(rettype, ptrclass, memclass) const rettype *
FUNC_P2VAR(rettype, ptrclass, memclass) rettype *
P2VAR(ptrtype, memclass, ptrclass) 	ptrtype *
P2CONST(ptrtype, memclass, ptrclass)  const ptrtype *
CONSTP2VAR(ptrtype, memclass, ptrclass) ptrtype * const
CONSTP2CONST(ptrtype, memclass, ptrclass) const ptrtype * const
P2FUNC(rettype, ptrclass, fctname) rettype (* fctname)
CONSTP2FUNC(rettype, ptrclass, fctname) rettype (* const fctname)
CONST(consttype, memclass) const consttype
VAR(vartype, memclass) vartype
P2P2VAR(ptrtype, memclass, ptrclass) ptrtype **

• 还有别的宏？

上述的内容比较常用，下面讲讲个性化的。

可能还会遇到各种各样奇奇怪怪的用法，甚至还有些函数在代码里都搜索不到，实际上都可能是宏甚至是字符串拼接宏。

例如常见的：

TASK(your_task_name)
 
{
 
...
 
}

实际上这是一个定义在OS User Interface系列头文件中的宏，

#define Task(TaskName) void Os_Task_##TaskName(void)

在C.tom中，就可以直接写上：

Task(TaskName) void Os_Task_##TaskName(void)

修改完之后，重启source insight或者rebuild工程，可以让修改生效！