利用C可变参数和宏定义来实现自己的日志系统
在嵌入式应用的开发过程中,日志系统是非常重要的!
特别是在生产环节出现了偶发性的、与当前的执行环境相关的bug的时候,
如果没有日志系统来追踪问题,很难进行问题重现。
因此,实现一个自己的日志系统是很有帮助、很必要的。
在软件模型上,一般是把日志系统编译成库文件。
应用程序直接调用库中提供的API接口函数,即可记录日志信息。
那么实现自己的日志系统需要有3个问题需要处理:
(1)日志API函数的设计。
(2)日志信息的缓存。
(3)日志信息的持久化,也就是写入到本地文件系统。
这篇文章主要说明第一个问题:日志API函数的设计。
先上代码:
测试
知识点
1.字符串字面量的拼接
在C语言中,字符串的拼接有很多种方法:memcpy,strcpy,strcat,sprintf等等。
在代码19行,使用了C语言中的字符串字面量拼接的方式,把 " %s:%d(%s) \"" format "\"\n" 这3个字符串拼接成一个字符串。
补充一下:
在日志系统代码中,有些地方需要格式化字符串。
使用sprintf是最方便的,但是也是效率最低的!
也可以利用一些第三方的库来实现字符串格式化,比如:fmtlib,facebook 的 folly format,google的 Abseil StrFormat。
当然,最好的方式是自己实现格式化特定类型的数据,可以显著的提高日志系统的吞吐量,下一篇文章再说说这部分代码。
2.可变参数
大家都知道,printf函数就是通过可变参数机制来实现的。
可变参数可以这样定义和使用:
(1)不带参数名
(2)带参数名
第20行代码用 __VA_ARGS__ 来代表宏定义参数中的三个点(...),也就是可变参数。
再来说说“##”。
如果调用:debug2("code = %d", 100); 这样调用没有问题。
如果调用:debug2("hello"); 这里调用时,在format后面没有传入任何参数,那么就会编译错误,因为在宏替换之后变成了 printf("hello",),第一个参数之后多了一个逗号,因此报错。
如果调用:debug3("hello, world!"); 这样就没有问题,因为debug3中在可变参数__VA_ARGS__的前面有“##”,当编译器发现没有传入参数时,会自动把format后面的逗号去掉,所以编译OK。
3.宏定义中的#和##
#的作用就是在预处理的时候,把宏参数进行“字符串化”,例如:
##的作用就是在预处理的时候,把两个宏参数进行“粘合”,例如:
不知道这篇文章是否给你带来小小的帮助?
如果需要文中的代码,请私信或邮件,很乐意分享。
另外,评论和转发都是免费的哦~~~