实现一个TODO宏
2016-03-22 15:11
295 查看
实现一个TODO宏
实现一个能产生warning的TODO宏,用于在代码里做备忘,效果:下面一步步来实现这个宏。
Let’s do it
手动让编译器报警(报错)可以用以下几个方法:1 2 3 4 5 | #warning sunnyxx #error sunnyxx #pragma message "sunnyxx" #pragma GCC warning "sunnyxx" #pragma GCC error "sunnyxx" |
#的预处理指令是无法被
#define的。好在C99提供了一个
_Pragma运算符可以把部分
#pragma指令字符串化:
1 2 3 4 5 | #pragma message "sunnyxx" // 等价于 _Pragma("message \"sunnyxx\"") // 需要注意双引号的转义 // 或 _Pragma("message(\"sunnyxx\")") // 需要注意双引号的转义 |
1 2 3 4 5 | #define SOME_WARNING _Pragma("message(\"报告大王!\")") int main() { SOME_WARNING // [!]报告大王! return 1; } |
1 2 | #define STRINGIFY(S) #S #define PRAGMA_MESSAGE(MSG) _Pragma(STRINGIFY(message(MSG))) |
STRINGIFY(S)将入参转化成字符串,省去了
_Pragma中全串加转义字符的困扰。
这时,一个基本功能的TODO宏就完成了,下面向其中加入额外的信息:
1 2 3 4 56 | // 两个已有的宏 |
两个常量字符串可以拼接成一个整串 “123””456” => “123456”
使用到3个预定义宏,
__COUNTER__宏展开次数的计数器,全局唯一;
__FILE__当前文件完整目录字符串;
__LINE__在当前文件第几行
在字符串中预定义宏应延时展开,如果将上面的
DEFER_STRINGIFY换成
STRINGIFY的话,如
__LINE__就不能被正确展开成行数,而是成了一个常量字符串
"__LINE__"
为了美化,warning message中可以使用
\n换行
于是,使用
FORMATTED_MESSAGE(MSG)宏就可以将带文件路径、序号、行数等信息加入到最终的warning中。
其实到这步已经OK了,为了让这个宏更加抢眼,还可以借鉴RAC,把宏定义成前面加
@的形式:
1 | #define KEYWORDIFY try {} @catch (...) {} |
@前缀了(空的try-catch会被编译器优化,所以没啥性能损耗)
最终版本
1 2 3 4 56 | #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
相关文章推荐
- iOS9中-被禁用的方法
- 关于HTTP中GET与POST的区别
- Spark远程调试IDE调试
- 解决Jenkins邮箱配置中,使用SSL连接的问题
- Java数据校验(Bean Validation / JSR303)
- LeetCode 1 Two Sum(unordered_map和map的区别)
- configure: error: GD build test failed. Please check the config.log
- zedboard u-boot编译的心路历程
- Git进一步学习
- Dubbo学习过程、使用经验分享及实现原理简单介绍
- hrbust/哈理工oj 1126 Final Destination II【矩阵快速幂+递推】
- 如何在OCA上贡献自己的Odoo代码?
- pc qq精简版
- Spark日志研究
- 【v2.x OGE教程 20】粒子效果
- 欧美脑计划战略错误? 缺失一面镜子
- php curl 例子
- Linux解决长时间占用CPU资源的方法(底半部)
- 用MVC做WinForm客户端
- python调试技巧