在非MFC程序中使用调试宏 ASSERT(),VERIFY()和 TRACE()

时间:2021-08-11 00:07:07

游戏制作已经开始采用C++了,却鲜有人选择使用MFC。但笔者觉得的 ASSERT(),VERIFY()和 TRACE()这几个宏很好用。所以就想自己写一个版本来适应Windows平台下不同的工程类型。

提醒:

  • ASSERT()被测试它的参数,若参数为0,则中断执行并打印一段说明消息。在 Release 版本的程序中它不起任何作用。
  • VERIFY()和 ASSERT()很相似,区别在于在 Release 版本中它仍然有效(译者注:原作者在这里没有讲清楚,VERIFY()不会打印说明,只是会对参数表达式求值)。
  • ASSERT()使用的时候必须保证参数表达式中不能有函数调用(译者注:ASSERT()宏在 Release 版本中不对表达式求值),因此对于任何有函数调用的参数表达式,应该使用宏 VERIFY(),以保证表达式中的函数调用在 Release 版本中会被正确求值。
  • TRACE()基本上就是函数 printf()的一个复制品,唯一的区别是它把结果输出到调试窗口。在 Release 版本中,它也是无效的。
  • 这三个宏在 Release 版本中都不会产生任何实质性的影响,它们是否起作用取决于是否定义了预定义了宏 _DEBUG。这是对 Microsoft Visual C++ 而言,在其它的编译器中可能其它不同的宏。
  • 这里是代码:

    1. #include "stdafx.h"
    2. #include <stdio.h>
    3. #include <stdarg.h>
    4. #include <windows.h>
    5. void _trace(char *fmt, ...);
    6. #ifdef _DEBUG
    7. #define ASSERT(x) {if(!(x)) _asm{int 0x03}}
    8. #define VERIFY(x) {if(!(x)) _asm{int 0x03}}     // 译注:为调试版本时产生中断有效
    9. #else
    10. #define ASSERT(x)
    11. #define VERIFY(x) x                             // 译注:为发行版本时不产生中断
    12. #endif
    13. #ifdef _DEBUG
    14. #define TRACE _trace
    15. #else
    16. inline void _trace(LPCTSTR fmt, ...) { }
    17. #define TRACE
    18. #endif
    19. void _trace(char *fmt, ...)
    20. {
    21. char out[1024];
    22. va_list body;
    23. va_start(body, fmt);
    24. vsprintf(out, fmt, body);     // 译注:格式化输入的字符串 fmtt
    25. va_end(body);                 //       到输出字符串 ou
    26. OutputDebugStringA(out);       // 译注:输出格式化后的字符串到调试器
    27. }