TRACE宏(只在MFC的DEBUG中有效)|VC++非MFC项目中如何自定义TRACE宏|头文件的重复编译|DEBUGVIEW窗口

怎么样使用VC的TRACE宏

收藏者: kingofmezlh1
转自: http://blog.csdn.net/houffee/article/details/2692629

TRACE宏对于VC下程序调试来说是很有用的东西,有着类似printf的功能;该宏仅仅在程序的DEBUG版本中出现,当RELEASE的时候该宏就完全消息了,从而帮助你调式也在RELEASE的时候减少代码量。

使用非常简单,格式如下:

TRACE("DDDDDDDDDDD");

temp=123;

TRACE("wewe%d",temp);

分别在调试窗口显示:

DDDDDDDDDDD

wewe123

 

 

同样还存在TRACE0,TRACE1,TRACE2。。。分别对应0,1,2。。个参数

TRACE信息输出到VC IDE环境的输出窗口(该窗口是你编译项目出错提示的哪个窗口),但仅限于你在VC中运行你的DEBUG版本的程序。

TRACE信息除了可以被VC IDE环境的输出窗口捕获到(即TRACE信息输出到VC IDE环境的输出窗口)以外,还可以使用DEBUGVIEW来捕获到。这种情况下,你不能在VC的IDE环境中(即不用点击vs界面上的调试按钮(即F5)来启动debug版本的程序,而是直接双击debug版本程序(如exe)来启动它(即如vs2010里点击“开始不调试”按钮,就是直接打开启动debug版本程序的意思))运行你的程序,而将BUILD好的DEBUG版本的程序单独运行,这个时候可以在DEBUGVIEW的窗口看到DEBUGVIE格式的输出。

=======================================================

TRACE

TRACE(exp)

  说明:
  把一个格式化字符串送到转储设备,例如,文件或调试监视器,而提供与printf相似的功能。同MS_DOSC程序的printf一样,TRACE宏是一个在程序运行时跟踪变量值的方便形式。在DEBUG环境中,TRACE宏输出到afxDump。在Release版中他不做任何工作。

  注释:此宏只在MFCDEBUG版中有效

TRACE0

TRACE0(exp)

  说明:
  与TRACE相似,但他把跟踪字符串放在代码段中,而不是DGROUP,因此使用少的DGROUP空间。TRACE0是一组跟踪宏的一个变体,这些宏可用于调试输出。这一组包括TRACE0,TRACE1,TRACE2TRACE3,这些宏不同在于所取参数的数目不同。TRACE0只取一个格式化字符串并可用于简单文本消息。TRACE1取一格式化字符串加上一个变量——一个将转储的变量。同样,TRACE2,TRACE3分别取2个或3个参数(在格式化字符串之后)。如果用户以便以了应用程序的发行版,那么它只把数据转储到afxDump

  注释:此宏只在MFCDEBUG中有效。

TRACE1

TRACE1(exp,param1) (一个表达式加上一个参数)
  说明:参见TRACE0

TRACE2

TRACE2(exp,param1,param2)
  说明:参见TRACE0

TRACE3

TRACE3(exp,param1,param2,param3)
  说明:参见TRACE0

 

总结用法如下:

1.MFC中加入TRACE语句

2.TOOLS->MFCTRACER中选择“ENABLE TRACING”点击OK

3.进行调试运行,GO(F5)(特别注意:不是执行‘!’以前之所以不能看到TRACE内容,是因为不是调试执行,而是‘!’了,切记,切记)

4.然后就会在OUTPUT中的DEBUG窗口中看到TRACE内容了,调试执行会自动从BUILD窗口跳到DEBUG窗口,在那里就看到TRACE的内容了

 

=====================================================================================

TRACE,TRACE0, TRACE1, TRACE2, TRACE3, AfxDump 都是干什么的???TRACE有什么用???

Debug 方式编译时输出调试信息,当Release方式编译时就不输出了。

解决方案 »

  1. 代替 printf("error message"); 一个很好的方法。
      
  2. 以下用法在VC中用F5调试,在调试窗口中会显示出调式值出来用法一(TRACE) // example for TRACE
    int i = 1;
    char sz[] = "one";
    TRACE( "Integer = %d, String = %s\n", i, sz );
    // Output: 'Integer = 1, String = one'用法二(TRACE0) // example for TRACE0
    TRACE0( "Start Dump of MyClass members:" );用法三(TRACE1) // example for TRACE1
    int i = 1;
    TRACE1( "Integer = %d\n", i );
    // Output: 'Integer = 1'用法四(TRACE2) // example for TRACE2
    int i = 1;
    char sz[] = "one";
    TRACE2( "Integer = %d, String = %s\n", i, sz );
    // Output: 'Integer = 1, String = one'
    在调试窗口中可看到输出结果。
      
  3. TRACE0, TRACE1, TRACE2, TRACE3, AfxDump, afxTraceEnabled 
    的区别是什么?
      
  4. 用afxDump可以在Debug方式下在"输出"里查看值:

  5. (afxDump)int nValue = 100;
  6. #ifdef _DEBUG   
    afxDump << "File could not be opened " << nValue << "\n";
    #endif
  7. DEBUG 输出值:File could not be opened 100


  8. TRACE0, TRACE1, TRACE2, TRACE3~~~~~~~上面有用法,用法的不同在于它们的输出参数不同。


  9. 而afxDump则直接与流符号“<<”来输出信息,输出的参数多个,与流符号“<<”的操作是完全相同的。
    (变量)afxTraceEnabled则用来对TRACE0, TRACE1, TRACE2, TRACE3宏是否有用。
    afxTraceEnabled = FALSE;  // 表TRACE无效
    afxTraceEnabled = TRUE;  // 表TRACE有效
     

========================================================


http://dev.gameres.com/Program/Other/DebugMacro.htm

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

作者:Gabriel Fleseriu 译者:WinDancer From:www.x-temple.com

  游戏制作已经开始采用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++ 而言,在其它的编译器中可能其它不同的宏。
  •   Since it makes no sense to re-invent the wheel(译者注:这好像是一句俗语,大致意思是“没有必要(意义)自己从头写起”,但原句究竟如何,在下水平有限,实难猜出。故将原文放上,望高人赐教,感激不尽!),笔者在看了 MFC 的代码之后类似地建立了自己的宏。对于 ASSERT()和 VERIFY()则去掉了花哨的“Debug assertion failed...”对话框,只是简单的产生一个单纯的断点中断。

      要使用 ASSERT(),VERIFY()和 TRACE(),有两个文件是必需的:debug.hdebug.cpp(这两个文件是程序员自己自定义的,不是系统提供的)。首先需要在工程中的主要头文件里中包含文件debug.h因为它本身没有包括其它任何头文件,所以不必担心会产生头件的包含递归( 假如头文件a里包含头文件b,而头文件b又包含头文件a,这样就构成了一个无止境的死循环,即所谓包含递归。通常,头文件被包含一次,就会被对应编译一次,而#pragma once可以避免头文件的重复编译?)另外还要将debug.cpp 加入到工程中的源文件中。

    这里是代码:

    // file debug.h
    #ifndef __DEBUG_H__
    #define __DEBUG_H__
    
    #ifdef _DEBUG
    
    void _trace(char *fmt, ...);
    
    #define ASSERT(x) {if(!(x)) _asm{int 0x03}}
    #define VERIFY(x) {if(!(x)) _asm{int 0x03}}  // 译注:为调试版本时产生中断有效
    
    #else
    #define ASSERT(x)
    #define VERIFY(x) x                  // 译注:为发行版本时不产生中断
    #endif
    
    #ifdef _DEBUG
    #define TRACE _trace
    
    #else
    inline void _trace(LPCTSTR fmt, ...) { }
    #define TRACE  1 ? (void)0 : _trace
    #endif
    
    #endif // __DEBUG_H__
    
    
    // file debug.cpp
    #ifdef _DEBUG
    #include <stdio.h>
    #include <stdarg.h>
    #include <windows.h>
    
    void _trace(char *fmt, ...)
    {
    	char out[1024];
    	va_list body;
    	va_start(body, fmt);
    	vsprintf(out, fmt, body);     // 译注:格式化输入的字符串 fmtt
    	va_end(body);                 // 到输出字符串 ou
    	OutputDebugString(out);       // 译注:输出格式化后的字符串到调试器
    }
    #endif
    

    译者续:一点小扩展

      大家可以看到宏 TRACE()的最后,调用的是 OutPutDebugString()函数,只能将信息输出到调试器窗口中,但我们同样也可以实现 MFC 中的弹出式窗口,只要用 MessageBox()函数输出就可以了。(不过……好像样子也不一样哎!)

    手记:

      此为本人的第一篇翻译习作,其中胡扯八道、乱七八糟、稀奇古怪之处数不胜数!(汗……)但看到这篇文章既短又小、语法简单,不翻白不翻,所以就操刀上阵,为大家做成这道小菜!

      不过说实话,这篇文章确实很不错,WinDancer 每次在写基于 WIN32 SDK 的程序时都会感叹没有这样的宏可用,相信也有很多同志也这么想过。虽然 SDK 下可以用 assert(),但却没有 TRACE()这样的好东东呀!现在有了这篇文章就可以了大家的心事了!


    —— WinDancer     
    于 2002 年 8 月 16 日夜
    =================================================

    VC++非MFC项目中如何使用TRACE宏

    记得原来尝试学MFC的时候觉得有一个TRACE可以在Debug时向VS的调试输出窗口输出字串符,用来调试时跟踪变量很方便。

    然则如果不是MFC项目或者ATL的项目的话是不能使用这个宏的。这时有一个没有什么额外消耗的办法能够做到向调试输出窗口输出。

    在项目中额外包含windows.h这个头文件,再使用OutputDebugString()这个函数就能够起到与TRACE()宏相同的效果。在进行一点包装就能和c中的printf一样接受不定项参数。

    下面程序做为范例。

     

    #include <iostream>

    #include <windows.h>

    using namespace std;


    bool _trace(TCHAR *format, ...)

    {

    TCHAR buffer[1000];


    va_list argptr;

    va_start(argptr, format);

    wvsprintf(buffer, format, argptr);

    va_end(argptr);


    OutputDebugString(buffer);


    return true;

    }


    int main() {

    int test = 5;

    _trace("hi output:%d", test);

    int a;

    cin >> a;

    }

    在vs2005中编译运行后在Output窗口输出"hi output : 5"

    这么nb的做法当然不是我自己发现的...在StackOverflow这里发帖问到的,那边还有一个方便使用的将trace包装的头文件和cpp文件。

    话说这个StackOverflow是个蛮新颖的程序员社区,这边提问被解答的效率和质量都相当高

    站点也做的很不错,web2.0风味十足,还有badges这种先进的要素

    -------------------------------------

    另外记得要将项目属性中General->Character Set设置为Not Set 或者Multi Byte才行,用Unicode的话无法通过编译。

    再附个包trace.rar有相应cpp/h

    ====================================


    你可能感兴趣的:(TRACE宏(只在MFC的DEBUG中有效)|VC++非MFC项目中如何自定义TRACE宏|头文件的重复编译|DEBUGVIEW窗口)