Click here to Skip to main content
Click here to Skip to main content
Go to top

Small and Simple TRACE/Log support for your Windows application

, 22 Feb 2006
Rate this:
Please Sign up or sign in to vote.
This header file will provide you with the smallest and simplest way to log some trace messages from your MFC application.

Introduction

Sometime while developing your next Windows application, you might want to add some simple logger or trace support into the _DEBUG version of the app. The standard Microsoft TRACE tool is just too inconvenient and weird. All you want is just printout some useful information from your code into text files, or maybe to the VS IDE output window. That is exactly what MyTrace does. Include one single header file into your project, and you are ready to go.

Usage

First of all, you need to include the mytrace.h header into your project. Then before you start logging any messages, you need to initialize MyTrace like this:

MYTRACE_INIT("MyApp_log.txt");
//Init MT with single log file

or if you want all really "bad bugs" to be reported into a separate file, then like this:

MYTRACE_INIT_EX("MyApp_log.txt", "MyApp_errors.txt");
// main log and error log files

Corresponding text files will be created in your application working folder. Optionally, you can set the minimal severity level for the messages you want to see in the logs (the default level is MT::LEVEL_INFO):

MYTRACE_LEVEL(MT::LEVEL_DEBUG);
// set minimal trace messages severity to report

And you can add trace messages like this:

MYTRACE(MT::LEVEL_INFO, 
    "\t\t\t MyApp v.%d.%d.%d started \n\n", 1, 0, 0);
MYTRACE(MT::LEVEL_ERROR, 
    "Wrong parameter: %s", wrongStringParameter);

And just before your application is about to close, do not forget to de-initialize MyTrace by a simple call like this:

MYTRACE_DEINIT;
// stop MT

Notes

You can choose one from the following severity levels for the trace message: LEVEL_ERROR, LEVEL_WARNING, LEVEL_INFO, or LEVEL_DEBUG.

If you initialize MyTrace with MYTRACE_INIT_EX then all messages with LEVEL_ERROR and LEVEL_WARNING levels will also be reported into separate error log text files for debugging convenience.

You can change some settings for MyTrace by commenting/un-commenting #defines on the top of the file.

  • #define MT_USE_ATLTRACE turns on/off the forwarding of messages to the standard Microsoft ATLTRACE macros. It enables you to see trace messages in the “output” window in the VS IDE. This is enabled by default.
  • #define MT_KEEP_ATLTRACE_LEVELS indicates if MyTrace severity levels should be treated as ATLTRACE levels also. By default, all messages forwarded to ATLTRACE with level 0.
  • #define MT_REDIRECT_STDOUT redirects global stdout into the MyTrace log file. You might want to do that if you want to grab all the output from the printf class functions, but that could interfere with your application behavior; so by default, this option is disabled.

This is an example of how the log records look like:

...
INFO    d:\projects\MyApp\MyAppMain.cpp(105) 02/20/06 09:00:41:
Starting Application...
DEBUG   d:\projects\MyApp\MyAppMain.cpp(322) 02/20/06 09:00:42:
Hello World
WARNING d:\projects\MyApp\MyAppMain.cpp(408) 02/20/06 09:00:43:
Runtime Excepton 1234
INFO    d:\projects\MyApp\MyAppMain.cpp(512) 02/20/06 09:00:44:
Closing Application...
...

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here

Share

About the Author

suggam
Web Developer
United States United States
No Biography provided

Comments and Discussions

 
QuestionGetting it to work on VS2010? PinmemberLars [Large] Werner1-Feb-11 7:30 
QuestionHow to use it when NO Format Msg Pinmemberchan™17-Jan-07 15:51 
GeneralVariadic macros PinmemberHokei28-Feb-06 18:35 
GeneralRe: Variadic macros Pinmembersuggam1-Mar-06 2:37 
GeneralSuggested change PinmemberHokei28-Feb-06 18:31 
GeneralRe: Suggested change Pinmembersuggam1-Mar-06 2:33 
GeneralRe: Suggested change PinmemberHokei1-Mar-06 2:52 
QuestionHow to clear the o/p window? PinmemberNader Nashaat28-Feb-06 1:49 
AnswerRe: How to clear the o/p window? Pinmembersuggam1-Mar-06 2:20 
Generallog4cxx PinsitebuilderUwe Keim22-Feb-06 9:48 
GeneralRe: log4cxx Pinmembersuggam22-Feb-06 9:57 
GeneralRe: log4cxx PinsitebuilderUwe Keim22-Feb-06 10:06 
GeneralRe: log4cxx Pinmembersuggam22-Feb-06 16:16 
GeneralRe: log4cxx PinmemberSam NG20-Mar-06 14:57 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Mobile
Web02 | 2.8.140916.1 | Last Updated 22 Feb 2006
Article Copyright 2006 by suggam
Everything else Copyright © CodeProject, 1999-2014
Terms of Service
Layout: fixed | fluid