我们在调试程序的时候,需要输出一些日志信息,用到NSLog函数,当我们准备发布程序,需要注释掉NSLog代码,这个时候在PrefixHeader.pch文件中定义宏,在调试的时候,输出日志,在Release正式版本的时候,关闭日志输出。举例如下:
#ifdef DEBUG
#define RJLog(fmt, ...) NSLog((fmt), ##__VA_ARGS__)
#else
#define RJLog(...)
#define RJLogFunc RJLog(@"%s", __func__)
#define RJLogFunc RJLog(@"%s", __func__) 或者 #define RJLogFunc(...) NSLog(@"%s", __func__) --- 这个定义指的是输出当前的方法名。
以上宏定义输出,是最常见的自定义NSLog的方式。下面是宏定义输出更为详细信息的例子:
#ifdef DEBUG
# define RJLog(fmt, ...) NSLog((@"[文件名:%s]\n" "[函数名:%s]\n" "[行号:%d] \n" fmt), __FILE__, __FUNCTION__, __LINE__, ##__VA_ARGS__);
#else
# define RJLog(...)
#endif
上述例子中各个参数释义:
1.__VA_ARGS__ 是一个可变参数的宏,很少人知道这个宏,这个可变参数的宏是新的C99规范中新增的,目前似乎只有gcc支持(VC6.0的编译器不支持)。宏前面加上##的作用在于,当可变参数的个数为0时,这里的##起到把前面多余的","去掉的作用,否则会编译出错。
2.__FILE__ 宏在预编译时会替换成当前的源文件名。
3.__LINE__宏在预编译时会替换成当前的行号。
4.__FUNCTION__宏在预编译时会替换成当前的函数名称有了以上这几个宏,特别是有了__VA_ARGS__ ,调试信息的输出就变得灵活多了。
题外话:
一、pch的作用:
1.存放一些全局的宏定义(整个项目中都用得上的宏);
2.用来包含一些全部的头文件(整个项目中都用得上的头文件);
3.能自动打开或者关闭日志输出功能。
二、在Xcode中创建pch文件
Command+N(或者右键选择New File...)打开新建文件窗口:iOS->Other->PCH File,创建一个pch文件
在工程的TARGETS里边Building Setting中搜索Prefix Header,然后把Precompile Prefix Header右边的NO改为Yes:
接着在Precompile Prefix Header下边的Prefix Header右边双击,添加刚刚创建的pch文件的工程路径,添加格式:“$(SRCROOT)/项目名称/pch文件名” ,$(SRCROOT)的意思就是工程根目录的意思。