只在DEBUG模式下才打印Log (不改变系统的Log内容)
作用:
只在DEBUG模式下才打印Log,可以减少在应用打包上线后,后台打印造成的性能浪费。OPTIMIZE是release默认会加的宏。
在工程的 .pch文件中加入如下代码:
#ifndef __OPTIMIZE__
#define NSLog(format, ...) do {(NSLog)((format) , ##__VA_ARGS__)} while (0)
#else
#define NSLog(format, ...) do{} while(0)
#endif
也可以采用这种方式:
#ifdef DEBUG
#define NSLog(format, ...) (NSLog)((format) , ##__VA_ARGS__)
#else
#define NSLog(format, ...) do{} while(0)
#endif
如果采用这种方式需要注意,必须在 "Target > Build Settings > Preprocessor Macros > Debug" 里设置"DEBUG=1"。(因为有的情况下,这个设置为空,需手动设置。如Unity3D生成的Xcode代码默认就没有设置)
对NSLog原生行为的改进,Log出文件位置,所在文件的代码行,方法名
#define NSLog(format, ...) do { \
fprintf(stderr, "<%s : %d> %s\n", \
[[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String], \
__LINE__, __func__); \
(NSLog)((format), ##__VA_ARGS__); \
fprintf(stderr, "-------\n"); \
} while (0)
合并以上两个功能(只在debug模式打印,同时改变系统log的行为)
#ifdef DEBUG
#define NSLog(format, ...) do { \
fprintf(stderr, "<%s : %d> %s\n", \
[[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String], \
__LINE__, __func__); \
(NSLog)((format), ##__VA_ARGS__); \
fprintf(stderr, "-------\n"); \
} while (0)
#else
#define NSLog(format, ...) do{} while(0)
#endif
预定义宏的行为是由编译器指定的。
__FILE__返回当前文件的绝对路径,
__LINE__返回展开该宏时在文件中的行数,
__func__是改宏所在scope的函数名称,
__VA_ARGS__表示的是宏定义中的...中的所有剩余参数,
##将前面的格式化字符串和后面的参数列表合并。
##除了拼接前后文本之外,还有一个功能,那就是如果后方文本为空,那么它会将前面一个逗号吃掉。这个特性当且仅当上面说的条件成立时才会生效,因此可以说是特例。加上这条规则后,我们就可以将刚才的式子展开为正确的(NSLog)((@"Hello"));了。
#单个井号的作用是字符串化,简单来说就是将替换后在两头加上“”
第二个参数是...,在宏定义(其实也包括函数定义)的时候,写为...的参数被叫做可变参数(variadic)。这里第一个格式化字符串即对应宏里的format,后面的变量全部映射为...作为整体处理。
使用do..while的原因:
这个吃掉分号的方法被大量运用在代码块宏中,几乎已经成为了标准写法。而且while(0)的好处在于,在编译的时候,编译器基本都会为你做好优化,把这部分内容去掉,最终编译的结果不会因为这个do while而导致运行效率上的差异。
参考文章
iOS开发:NSLog使用技巧
宏定义的黑魔法 - 宏菜鸟起飞手册
以下宏定义的内容是摘自宏定义的黑魔法 - 宏菜鸟起飞手册
C中的宏分为两类,对象宏(object-like macro)和函数宏(function-like macro)。
连着的井号##在宏中是一个特殊符号,它表示将两个参数连接起来这种运算。
__COUNTER__
是一个预定义的宏,这个值在编译过程中将从0开始计数,每次被调用时加1。因为唯一性,所以很多时候被用来构造独立的变量名称。
MIN(a,b)的最佳实现
#define __NSX_PASTE__(A,B) A##B
#define MIN(A,B) __NSMIN_IMPL__(A,B,__COUNTER__)
#define __NSMIN_IMPL__(A,B,L) ({
__typeof__(A) __NSX_PASTE__(__a,L) = (A); \
__typeof__(B) __NSX_PASTE__(__b,L) = (B); \
(__NSX_PASTE__(__a,L) < __NSX_PASTE__(__b,L)) ? __NSX_PASTE__(__a,L) : __NSX_PASTE__(__b,L); \
})
优雅,高效NSLog宏定义:
//A better version of NSLog
#define NSLog(format, ...) do { \
fprintf(stderr, "<%s : %d> %s\n", \
[[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String], \
__LINE__, __func__); \
(NSLog)((format), ##__VA_ARGS__); \
fprintf(stderr, "-------\n"); \
} while (0)
预定义宏的行为是由编译器指定的。
__FILE__返回当前文件的绝对路径,
__LINE__返回展开该宏时在文件中的行数,
__func__是改宏所在scope的函数名称,
__VA_ARGS__表示的是宏定义中的...中的所有剩余参数,
##将前面的格式化字符串和后面的参数列表合并。
##除了拼接前后文本之外,还有一个功能,那就是如果后方文本为空,那么它会将前面一个逗号吃掉。这个特性当且仅当上面说的条件成立时才会生效,因此可以说是特例。加上这条规则后,我们就可以将刚才的式子展开为正确的(NSLog)((@"Hello"));了。
#单个井号的作用是字符串化,简单来说就是将替换后在两头加上“”
第二个参数是...,在宏定义(其实也包括函数定义)的时候,写为...的参数被叫做可变参数(variadic)。这里第一个格式化字符串即对应宏里的format,后面的变量全部映射为...作为整体处理。
使用do..while的原因:
这个吃掉分号的方法被大量运用在代码块宏中,几乎已经成为了标准写法。而且while(0)的好处在于,在编译的时候,编译器基本都会为你做好优化,把这部分内容去掉,最终编译的结果不会因为这个do while而导致运行效率上的差异。
示例:
if (errorHappend)
NSLog(@"Oops, error happened");
else
//Yep, no error, I am happy~ :)
宏替换后:
if (errorHappend) {
fprintf((stderr, "<%s : %d> %s\n",[[[NSString stringWithUTF8String:__FILE__] lastPathComponent] UTF8String], __LINE__, __func__);
(NSLog)((format), ##__VA_ARGS__);
fprintf(stderr, "-------\n");
}; else {
//Yep, no error, I am happy~ :)
}
可以发现多出来一个分号,此时会编译不通过。