有时候项目中需要使用到自定义的输出方法,来添加特定的输出信息,用以帮助我们快速定位异常。在C语言中,有一个很常用的标准输出函数printf,以该函数为基础,我们来写一个简单的实现。
需求:需要额外输出函数的该日志所在方法以及在该实现中的位置(在源代码中的行数)。
分开Debug模式和Release模式,使用通过定义宏,让其接收可变数目的参数,并使用printf重新定义输出,增加我们需要的参数。
#if DEBUG
#define DSLog(FORMAT,...) printf(stderr,"\nFunction:%s\n, line:%d\n, content:%s\n", __FUNCTION__, __LINE__, [[NSString stringWithFormat:FORMAT, ##__VA_ARGS__] UTF8String])
#else
#define DSLog(FORMAT,...) nil
#end
需要注意的是
- printf是C的标准输出函数,所以相关的参数需要转化成对应的类型;
- __VA_ARGS__ 是一个可变参数的宏,实现思想就是宏定义中参数列表的最后一个参数为省略号,而##__VA_ARGS__ 宏前面加上##的作用在于,当可变参数的个数为0时,这里的##起到把前面多余的","去掉的作用,否则会编译出错.
除此之外,C还有一个用于文件操作的输出函数fprintf,该函数原型比printf多了一个FILE类型的参数:
fprintf(FILE *restrict,const char *restrict, ...)
printf(constchar *restrict, ...)
这个多出来的参数,我们使用标准输出文件stderr,即对应终端的屏幕。所以以上需求我们还可以有另一种实现:
#if DEBUG
#define DSLog(FORMAT,...) fprintf(stderr,"\nFunction:%s,\n Line:%d,\n Content:%s\n", __FUNCTION__, __LINE__, [[NSString stringWithFormat:FORMAT, ##__VA_ARGS__] UTF8String])
#else
#define DSLog(FORMAT,...) nil
#end
当然如果你非常热衷使用NSLog的话,也是可以使用的:
#if DEBUG
#define DSLog(format,...) \
{ \
NSString *message = [NSString stringWithFormat:@"DEBUG[Log]:\nFunction:%s,\n Line:%d,\n content:" format "\n", __FUNCTION__, __LINE__,## __VA_ARGS__]; \
NSLog(@"%@", message); \
}
#else
#define DSLog(format,...) nil
#endif