VC++ TRACE

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

使用非常简单，格式如下：

TRACE("DDDDDDDDDDD");

TRACE("wewe%d",333);

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

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

TRACE信息还可以使用DEBUGVIEW来捕获到。这种情况下，你不能在VC的IDE环境中运行你的程序，而将BUILD好的DEBUG版本的程序单独运行，这个时候可以在DEBUGVIEW的窗口看到DEBUGVIE格式的输出了。

VC中TRACE的用法有以下四种：

1:

TRACE  ，就是不带动态参数输出字符串,   类似C的printf("输出字符串"); 
   
2:

  TRACE   中的字符串可以带一个参数输出  , 类似C的printf("...%d",变量);    
   
3:

  TRACE   可以带两个参数输出，类似C的printf("...%d...%f",变量1,变量2);    
   
4:

  TRACE   可以带三个参数输出，类似C的printf("...%d，%d,%d",变量1,变量2，变量3);

TRACE 宏有点象我们以前在C语言中用的Printf函数，使程序在运行过程中输出一些调试信息，使我们能了解程序的一些状态。但有一点不同的是：

TRACE 宏只有在调试状态下才有所输出，而以前用的Printf 函数在任何情况下都有输出。和Printf 函数一样，TRACE函数可以接受多个参数如：

int x = 1;
int y = 16;
float z = 32.0;
TRACE( "This is a TRACE statement/n" );
TRACE( "The value of x is %d/n", x );
TRACE( "x = %d and y = %d/n", x, y );
TRACE( "x = %d and y = %x and z = %f/n", x, y, z );

要注意的是TRACE宏只对Debug 版本的工程产生作用，在Release 版本的工程中，TRACE宏将被忽略。

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

在#include "stdafx.h"后加入：#include "afxwin.h",再将程序设置为使用动态MFC即可。

 

• 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.h 和debug.cpp。首先需要在工程中的主要头文件里中包含文件 debug.h。因为它本身没有包括其它任何头文件，所以不必担心会产生头件的包含递归。另外还要将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

---