【搬运】实现一个有意思的TODO宏
2016-04-26 12:39
369 查看
实现一个能产生warning的TODO宏,用于在代码里做备忘,效果:
下面一步步来实现这个宏。
手动让编译器报警(报错)可以用以下几个方法:
但我们知道,带
利用这个特性,我们就可以将warning定义成宏
接下来,我们让这个宏能够接受入参,并显示到warning中去,这里会面临宏的基本用法的考验。
个人认为不太可能在一个宏定义中完成这件事,需要用到辅助宏:
这时,一个基本功能的TODO宏就完成了,下面向其中加入额外的信息:
其中涉及到的知识:
两个常量字符串可以拼接成一个整串 “123””456” => “123456”
使用到3个预定义宏,
在字符串中预定义宏应延时展开,如果将上面的
为了美化,warning message中可以使用
于是,使用
其实到这步已经OK了,为了让这个宏更加抢眼,还可以借鉴RAC,把宏定义成前面加
将最终的宏定义前面加上上面的宏后,使用时就可以加
除此之外,还研究了半天如何在宏里面定义一个注释,这样就可以偷偷写
但很可惜没有找到一个可行的方法,欢迎一起解决。
Xcode插件《XTodo》也是利用这个特性,可以尝试下。
如果需要一个产生error的宏,将这里替换成这样就好了:
同时,上面的代码在《github上》可以找到。也欢迎关注微博@我就叫Sunny怎么了一起交流。
http://clang.llvm.org/docs/UsersManual.html
https://gcc.gnu.org/onlinedocs/cpp/Pragmas.html
下面一步步来实现这个宏。
Let’s do it
手动让编译器报警(报错)可以用以下几个方法:#warning sunnyxx #error sunnyxx #pragma message "sunnyxx" #pragma GCC warning "sunnyxx" #pragma GCC error "sunnyxx" |
#的预处理指令是无法被
#define的。好在C99提供了一个
_Pragma运算符可以把部分
#pragma指令字符串化:
#pragma message "sunnyxx" // 等价于 _Pragma("message \"sunnyxx\"") // 需要注意双引号的转义 // 或 _Pragma("message(\"sunnyxx\")") // 需要注意双引号的转义 |
#define SOME_WARNING _Pragma("message(\"报告大王!\")") int main() { SOME_WARNING // [!]报告大王! return 1; } |
#define STRINGIFY(S) #S #define PRAGMA_MESSAGE(MSG) _Pragma(STRINGIFY(message(MSG))) |
STRINGIFY(S)将入参转化成字符串,省去了
_Pragma中全串加转义字符的困扰。
这时,一个基本功能的TODO宏就完成了,下面向其中加入额外的信息:
// 两个已有的宏 |
两个常量字符串可以拼接成一个整串 “123””456” => “123456”
使用到3个预定义宏,
__COUNTER__宏展开次数的计数器,全局唯一;
__FILE__当前文件完整目录字符串;
__LINE__在当前文件第几行
在字符串中预定义宏应延时展开,如果将上面的
DEFER_STRINGIFY换成
STRINGIFY的话,如
__LINE__就不能被正确展开成行数,而是成了一个常量字符串
"__LINE__"
为了美化,warning message中可以使用
\n换行
于是,使用
FORMATTED_MESSAGE(MSG)宏就可以将带文件路径、序号、行数等信息加入到最终的warning中。
其实到这步已经OK了,为了让这个宏更加抢眼,还可以借鉴RAC,把宏定义成前面加
@的形式:
#define KEYWORDIFY try {} @catch (...) {} |
@前缀了(空的try-catch会被编译器优化,所以没啥性能损耗)
最终版本
#define STRINGIFY(S) #S |
What’s more
除此之外,还研究了半天如何在宏里面定义一个注释,这样就可以偷偷写// TODO: ...的注释,让Xcode导航栏中也出现这个TODO了:
但很可惜没有找到一个可行的方法,欢迎一起解决。
Xcode插件《XTodo》也是利用这个特性,可以尝试下。
如果需要一个产生error的宏,将这里替换成这样就好了:
_Pragma(STRINGIFY(GCC error(MSG)))
同时,上面的代码在《github上》可以找到。也欢迎关注微博@我就叫Sunny怎么了一起交流。
References
http://clang.llvm.org/docs/UsersManual.htmlhttps://gcc.gnu.org/onlinedocs/cpp/Pragmas.html
相关文章推荐
- CSS div display:inline-block(转自最初的你的博客)
- [BS-10] 统一设置app所有页面的“返回”按钮样式
- 如何解决ajax跨域问题
- shader forge初级篇|属性设置
- Mysql-5.7.11-winx64安装步骤
- Java使用OpenCV
- 拨号器
- wince6下载地址
- P2P网络“自由”穿越NAT的“秘密”原理
- 【面试题解答】如何在一个对象释放的时候收到通知
- Android异步更新UI的几种方法
- zookeeper单节点的安装
- 黑魔法__attribute__((cleanup))
- ASimpleCache框架源码链接 https://github.com/yangfuhai/ASimpleCache
- 顺序线性表
- 一张图明白各个屏幕iPhone的渲染
- django实现github第三方本地登录
- LightOJ 1094-1094 - Farthest Nodes in a Tree【树的直径模板】
- Int转NSString的高大上写法
- iOS8初探 - Size Class