C语言封装自己的TRACE函数

1. 文章目的

写代码的时候经常需要通过打印trace来debug代码，于是就有了自己封装一个TRACE函数的想法。

2. 知识点

（1）打印trace的时候每一次需要打印的参数个数不是一定的。所以这里需要用到C语言的可变参数的定义。

//可变参数用...来表示
void TRACE(char *format, ...)

（2）可变参数函数需要用到的宏
需要include的文件stdarg.h
va_list: 指针类型的宏，指向参数列表的参数
void va_start(va_list arg_list, last_arg): 指向参数列表中的最后一个固定参数
void va_end(va_list arg_list) : 释放参数列表指针
type va_arg(va_list arg_list, type) : 获取参数列表中的下一个参数，以type类型返回。

3. 代码实现

#include <stdio.h>
#include <stdarg.h>

typedef unsigned int uint16_t;
 
void TRACE(char *format, ...);
void TRACE(char *format, ...)
{
	va_list args_list;
	va_start(args_list , format); //va_start 的第一个参数为va_list变量，第二个参数为函数的最后一个固定参数
	char buff[1024];
	vsnprintf(buff, 1023 , format , args_list);
	printf("%s\n",buff);
	va_end(args_list);
}
 
int main()
{
	uint16_t testValue = 789;

	TRACE("hello world");
	TRACE("The testValue = %u", testValue);
	return 0;
}

4. 封装成自己的头文件

文件名为trace.h, 以后需要用到这个函数直接include这个头文件就可以了。

#ifndef TRACE_H_
#define TRACE_H_

#include <stdio.h>
#include <stdarg.h>

typedef unsigned int uint16_t;
 
void TRACE(char *format, ...);
void TRACE(char *format, ...)
{
	va_list args_list;
	va_start(args_list , format); //va_start 的第一个参数为va_list变量，第二个参数为函数的最后一个固定参数
	char buff[1024];
	vsnprintf(buff, 1023 , format , args_list);
	printf("%s\n",buff);
	va_end(args_list);
}

#endif /*TRACE_H_*/