使用 pragma message 查找多变的 DEBUG 宏

简介: 使用 pragma message 查找多变的 DEBUG 宏

前言

这是 N 年前遇到的一个问题了。最近跟 DEBUG 宏对着干上了,正好翻到这篇总结 —— 记录了使用 pragma message 排查 同一个工程不同 CPPDEBUG 宏的值不同的过程。现对之前的总结做了更新整理,分享给各位小伙伴儿。

pragma message

使用 #pragma message 可以在编译的过程输出我们指定的信息,是排查编译问题的好帮手。以下例子摘自微软官方文档,感兴趣小伙伴儿可以直接添加到自己的工程中使用。

// pragma_directives_message1.cpp
// compile with: /LD
#if _M_IX86 >= 500
#pragma message("_M_IX86 >= 500")
#endif

#pragma message( "Compiling " __FILE__ )
#pragma message( "Last modified on " __TIMESTAMP__ )

// with line number
#define STRING2(x) #x
#define STRING(x) STRING2(x)

#pragma message (__FILE__ "[" STRING(__LINE__) "]: test")

下图是微软官方介绍 #pragma message 的文档截图,方便各位小伙伴儿阅读。

pragma-message-msdn.png

现象

test1.cppDEBUG 宏是定义了的,在 test2.cppDEBUG 宏并没有被定义。你有可能会好奇我是怎么知道的?我分别在 test1.cpptest2.cpp 里加了如下代码:

#ifdef DEBUG
#pragma message ("--------> DEBUG defined in file : " __FILE__)
#else
#pragma message ("--------> DEBUG NOT defined in file : " __FILE__)
#endif

test1.cpptest2.cpp 中,智能提示如下图:

intellisense-tip-debug-macro.png

编译输出如下图:

build-output-compare.png

从智能提示和编译输出信息都可以明显的看出,在 test1.cppDEBUG 宏是定义了的,在 test2.cppDEBUG 宏并没有被定义。好奇怪的现象。

查看工程配置

难道 DEBUG 宏不是根据工程配置来的吗?为此,特地查看了工程预定义宏。

project-defined-macros.png

从上图可知,只定义了 _DEBUG,并没有定义 DEBUG。之前一直以为定义了 _DEBUG 就同时定义了 DEBUG

看来 DEBUG_DEBUG 不一样!虽然知道了在工程中没有定义 DEBUG 宏,但是为什么在两个 cpp 里的表现不一样呢?

继续调查

继续使用伟大的 #pragma message 来排查,最后发现 test.cpp 包含了 tinyxml 库中的头文件 tinyxml.h,在此头文件中有如下语句。

tinyxml-define-debug-macro.png

至此,真相大白!!!

实战

如果你也想动手实战,可以使用下面的示例工程。

百度云 链接: https://pan.baidu.com/s/1_7RKFf-jrSdjdBZihnPl1Q 提取码: eu8f

CSDN 链接:https://download.csdn.net/download/xiaoyanilw/12502953

总结

DEBUG_DEBUG 是两个不同的宏。“官方” 支持的是 _DEBUG 而不是 DEBUG。尽量使用 _DEBUG 而不是 DEBUG

参考资料

https://docs.microsoft.com/en-us/cpp/preprocessor/message?view=vs-2019

相关文章
|
8月前
|
C语言
C语言使用宏定义实现等级调试输出PRINT_LEVEL
C语言使用宏定义实现等级调试输出PRINT_LEVEL
153 0
|
8月前
|
C++
VS code debug c代码 配置
VS code debug c代码 配置
77 0
|
8月前
|
算法 Serverless C语言
CMake函数和宏(function和macro):使用函数和宏提高代码可读性
CMake函数和宏(function和macro):使用函数和宏提高代码可读性
174 1
|
8月前
|
C++
Qt定义属性类信息报错‘Qstring‘ was not declared in this scope; did you mean ‘xxx‘?并且还有有一堆报错,问题还出现在moc文件
Qt定义属性类信息报错‘Qstring‘ was not declared in this scope; did you mean ‘xxx‘?并且还有有一堆报错,问题还出现在moc文件
143 0
|
8月前
|
编译器 程序员 C++
[C++] #ifndef和#define与#pragma once在头文件中的作用和关系
[C++] #ifndef和#define与#pragma once在头文件中的作用和关系
112 0
|
前端开发
【前端验证】对uvm_info宏的进一步封装尝试
【前端验证】对uvm_info宏的进一步封装尝试
|
编译器 C语言
宏、条件编译(#ifdef)、#include(头文件包含)、#error和 #pragma的区别、#和##的含义和应用
宏、条件编译(#ifdef)、#include(头文件包含)、#error和 #pragma的区别、#和##的含义和应用
115 0
|
编译器 C++
Dev-c++中将头文件和头文件函数分离,编译主函数跳出undefined reference to 的问题解决
Dev-c++中将头文件和头文件函数分离,编译主函数跳出undefined reference to 的问题解决
Dev-c++中将头文件和头文件函数分离,编译主函数跳出undefined reference to 的问题解决
|
开发工具
组件化项目使用NS_OPTIONS宏的坑
TLDR:项目中有一个SDK向外暴露了NS_OPTIONS宏,我修改了宏的值,导致出现Bug。NS_OPTIONS本质是宏,A组件使用了B组件的NS_OPTIONS,当A组件构建为二进制包时,预编译期会将NS_OPTIONS变量替换为固定的值。一旦B组件修改了NS_OPTIONS的值,A组件就会出现逻辑Bug。具体描述:事情是这样,我开发一个需求,涉及A和B两个模块,它们是独立的二进制组件。A模块
143 0
|
Web App开发 C语言
分析 chrome 源码中 WARN_UNUSED_RESULT 宏
问题 今天浏览 chrome 源码时,发现了一个非常有意思的宏定义,它就是 WARN_UNUSED_RESULT ,用法如下图所示:
430 0

热门文章

最新文章

下一篇
开通oss服务