1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Assorted wxLogXXX functions, and wxLog (sink for logs)
4 // Author: Vadim Zeitlin
8 // Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
17 // ----------------------------------------------------------------------------
18 // common constants for use in wxUSE_LOG/!wxUSE_LOG
19 // ----------------------------------------------------------------------------
21 // the trace masks have been superceded by symbolic trace constants, they're
22 // for compatibility only andwill be removed soon - do NOT use them
24 // meaning of different bits of the trace mask (which allows selectively
25 // enable/disable some trace messages)
26 #define wxTraceMemAlloc 0x0001 // trace memory allocation (new/delete)
27 #define wxTraceMessages 0x0002 // trace window messages/X callbacks
28 #define wxTraceResAlloc 0x0004 // trace GDI resource allocation
29 #define wxTraceRefCount 0x0008 // trace various ref counting operations
32 #define wxTraceOleCalls 0x0100 // OLE interface calls
35 // ----------------------------------------------------------------------------
37 // ----------------------------------------------------------------------------
39 // NB: these types are needed even if wxUSE_LOG == 0
40 typedef unsigned long wxTraceMask
;
41 typedef unsigned long wxLogLevel
;
43 // ----------------------------------------------------------------------------
45 // ----------------------------------------------------------------------------
47 #include "wx/string.h"
48 #include "wx/strvararg.h"
52 #include "wx/arrstr.h"
55 #include <time.h> // for time_t
58 #include "wx/dynarray.h"
60 #ifndef wxUSE_LOG_DEBUG
62 # define wxUSE_LOG_DEBUG 1
63 # else // !__WXDEBUG__
64 # define wxUSE_LOG_DEBUG 0
68 // ----------------------------------------------------------------------------
69 // forward declarations
70 // ----------------------------------------------------------------------------
73 class WXDLLIMPEXP_CORE wxTextCtrl
;
74 class WXDLLIMPEXP_CORE wxLogFrame
;
75 class WXDLLIMPEXP_CORE wxFrame
;
76 class WXDLLIMPEXP_CORE wxWindow
;
79 // ----------------------------------------------------------------------------
81 // ----------------------------------------------------------------------------
83 // different standard log levels (you may also define your own)
86 wxLOG_FatalError
, // program can't continue, abort immediately
87 wxLOG_Error
, // a serious error, user must be informed about it
88 wxLOG_Warning
, // user is normally informed about it but may be ignored
89 wxLOG_Message
, // normal message (i.e. normal output of a non GUI app)
90 wxLOG_Status
, // informational: might go to the status line of GUI app
91 wxLOG_Info
, // informational message (a.k.a. 'Verbose')
92 wxLOG_Debug
, // never shown to the user, disabled in release mode
93 wxLOG_Trace
, // trace messages are also only enabled in debug mode
94 wxLOG_Progress
, // used for progress indicator (not yet)
95 wxLOG_User
= 100, // user defined levels start here
99 // symbolic trace masks - wxLogTrace("foo", "some trace message...") will be
100 // discarded unless the string "foo" has been added to the list of allowed
101 // ones with AddTraceMask()
103 #define wxTRACE_MemAlloc wxT("memalloc") // trace memory allocation (new/delete)
104 #define wxTRACE_Messages wxT("messages") // trace window messages/X callbacks
105 #define wxTRACE_ResAlloc wxT("resalloc") // trace GDI resource allocation
106 #define wxTRACE_RefCount wxT("refcount") // trace various ref counting operations
109 #define wxTRACE_OleCalls wxT("ole") // OLE interface calls
112 #include "wx/iosfwrap.h"
114 // ----------------------------------------------------------------------------
115 // derive from this class to redirect (or suppress, or ...) log messages
116 // normally, only a single instance of this class exists but it's not enforced
117 // ----------------------------------------------------------------------------
119 class WXDLLIMPEXP_BASE wxLog
125 // these functions allow to completely disable all log messages
127 // is logging disabled now?
128 static bool IsEnabled() { return ms_doLog
; }
130 // change the flag state, return the previous one
131 static bool EnableLogging(bool doIt
= true)
132 { bool doLogOld
= ms_doLog
; ms_doLog
= doIt
; return doLogOld
; }
134 // static sink function - see DoLog() for function to overload in the
136 static void OnLog(wxLogLevel level
, const wxChar
*szString
, time_t t
);
140 // flush shows all messages if they're not logged immediately (FILE
141 // and iostream logs don't need it, but wxGuiLog does to avoid showing
142 // 17 modal dialogs one after another)
143 virtual void Flush();
145 // flush the active target if any
146 static void FlushActive()
148 if ( !ms_suspendCount
)
150 wxLog
*log
= GetActiveTarget();
156 // only one sink is active at each moment
157 // get current log target, will call wxApp::CreateLogTarget() to
158 // create one if none exists
159 static wxLog
*GetActiveTarget();
161 // change log target, pLogger may be NULL
162 static wxLog
*SetActiveTarget(wxLog
*pLogger
);
164 // suspend the message flushing of the main target until the next call
165 // to Resume() - this is mainly for internal use (to prevent wxYield()
166 // from flashing the messages)
167 static void Suspend() { ms_suspendCount
++; }
169 // must be called for each Suspend()!
170 static void Resume() { ms_suspendCount
--; }
172 // functions controlling the default wxLog behaviour
173 // verbose mode is activated by standard command-line '-verbose'
175 static void SetVerbose(bool bVerbose
= true) { ms_bVerbose
= bVerbose
; }
177 // Set log level. Log messages with level > logLevel will not be logged.
178 static void SetLogLevel(wxLogLevel logLevel
) { ms_logLevel
= logLevel
; }
180 // should GetActiveTarget() try to create a new log object if the
182 static void DontCreateOnDemand();
184 // log the count of repeating messages instead of logging the messages
186 static void SetRepetitionCounting(bool bRepetCounting
= true)
187 { ms_bRepetCounting
= bRepetCounting
; }
189 // gets duplicate counting status
190 static bool GetRepetitionCounting() { return ms_bRepetCounting
; }
192 // trace mask (see wxTraceXXX constants for details)
193 static void SetTraceMask(wxTraceMask ulMask
) { ms_ulTraceMask
= ulMask
; }
195 // add string trace mask
196 static void AddTraceMask(const wxString
& str
)
197 { ms_aTraceMasks
.push_back(str
); }
199 // add string trace mask
200 static void RemoveTraceMask(const wxString
& str
);
202 // remove all string trace masks
203 static void ClearTraceMasks();
205 // get string trace masks
206 static const wxArrayString
&GetTraceMasks() { return ms_aTraceMasks
; }
208 // sets the timestamp string: this is used as strftime() format string
209 // for the log targets which add time stamps to the messages - set it
210 // to NULL to disable time stamping completely.
211 static void SetTimestamp(const wxChar
*ts
) { ms_timestamp
= ts
; }
216 // gets the verbose status
217 static bool GetVerbose() { return ms_bVerbose
; }
220 static wxTraceMask
GetTraceMask() { return ms_ulTraceMask
; }
222 // is this trace mask in the list?
223 static bool IsAllowedTraceMask(const wxChar
*mask
);
225 // return the current loglevel limit
226 static wxLogLevel
GetLogLevel() { return ms_logLevel
; }
228 // get the current timestamp format string (may be NULL)
229 static const wxChar
*GetTimestamp() { return ms_timestamp
; }
234 // put the time stamp into the string if ms_timestamp != NULL (don't
235 // change it otherwise)
236 static void TimeStamp(wxString
*str
);
238 // make dtor virtual for all derived classes
242 // this method exists for backwards compatibility only, don't use
243 bool HasPendingMessages() const { return true; }
245 #if WXWIN_COMPATIBILITY_2_6
246 // this function doesn't do anything any more, don't call it
247 wxDEPRECATED( static wxChar
*SetLogBuffer(wxChar
*buf
, size_t size
= 0) );
251 // the logging functions that can be overriden
253 // default DoLog() prepends the time stamp and a prefix corresponding
254 // to the message to szString and then passes it to DoLogString()
255 virtual void DoLog(wxLogLevel level
, const wxChar
*szString
, time_t t
);
257 // default DoLogString does nothing but is not pure virtual because if
258 // you override DoLog() you might not need it at all
259 virtual void DoLogString(const wxChar
*szString
, time_t t
);
261 // log a line containing the number of times the previous message was
263 // returns: the number
264 static unsigned DoLogNumberOfRepeats();
270 // traditional behaviour or counting repetitions
271 static bool ms_bRepetCounting
;
272 static wxString ms_prevString
; // previous message that was logged
273 // how many times the previous message was logged
274 static unsigned ms_prevCounter
;
275 static time_t ms_prevTimeStamp
;// timestamp of the previous message
276 static wxLogLevel ms_prevLevel
; // level of the previous message
278 static wxLog
*ms_pLogger
; // currently active log sink
279 static bool ms_doLog
; // false => all logging disabled
280 static bool ms_bAutoCreate
; // create new log targets on demand?
281 static bool ms_bVerbose
; // false => ignore LogInfo messages
283 static wxLogLevel ms_logLevel
; // limit logging to levels <= ms_logLevel
285 static size_t ms_suspendCount
; // if positive, logs are not flushed
287 // format string for strftime(), if NULL, time stamping log messages is
289 static const wxChar
*ms_timestamp
;
291 static wxTraceMask ms_ulTraceMask
; // controls wxLogTrace behaviour
292 static wxArrayString ms_aTraceMasks
; // more powerful filter for wxLogTrace
295 // ----------------------------------------------------------------------------
296 // "trivial" derivations of wxLog
297 // ----------------------------------------------------------------------------
299 // log everything to a buffer
300 class WXDLLIMPEXP_BASE wxLogBuffer
: public wxLog
305 // get the string contents with all messages logged
306 const wxString
& GetBuffer() const { return m_str
; }
308 // show the buffer contents to the user in the best possible way (this uses
309 // wxMessageOutputMessageBox) and clear it
310 virtual void Flush();
313 virtual void DoLog(wxLogLevel level
, const wxChar
*szString
, time_t t
);
314 virtual void DoLogString(const wxChar
*szString
, time_t t
);
319 DECLARE_NO_COPY_CLASS(wxLogBuffer
)
323 // log everything to a "FILE *", stderr by default
324 class WXDLLIMPEXP_BASE wxLogStderr
: public wxLog
327 // redirect log output to a FILE
328 wxLogStderr(FILE *fp
= (FILE *) NULL
);
331 // implement sink function
332 virtual void DoLogString(const wxChar
*szString
, time_t t
);
336 DECLARE_NO_COPY_CLASS(wxLogStderr
)
339 #if wxUSE_STD_IOSTREAM
341 // log everything to an "ostream", cerr by default
342 class WXDLLIMPEXP_BASE wxLogStream
: public wxLog
345 // redirect log output to an ostream
346 wxLogStream(wxSTD ostream
*ostr
= (wxSTD ostream
*) NULL
);
349 // implement sink function
350 virtual void DoLogString(const wxChar
*szString
, time_t t
);
352 // using ptr here to avoid including <iostream.h> from this file
353 wxSTD ostream
*m_ostr
;
356 #endif // wxUSE_STD_IOSTREAM
358 // ----------------------------------------------------------------------------
359 // /dev/null log target: suppress logging until this object goes out of scope
360 // ----------------------------------------------------------------------------
368 // wxFile.Open() normally complains if file can't be opened, we don't
372 if ( !file.Open("bar") )
373 ... process error ourselves ...
375 // ~wxLogNull called, old log sink restored
378 class WXDLLIMPEXP_BASE wxLogNull
381 wxLogNull() : m_flagOld(wxLog::EnableLogging(false)) { }
382 ~wxLogNull() { (void)wxLog::EnableLogging(m_flagOld
); }
385 bool m_flagOld
; // the previous value of the wxLog::ms_doLog
388 // ----------------------------------------------------------------------------
389 // chaining log target: installs itself as a log target and passes all
390 // messages to the real log target given to it in the ctor but also forwards
391 // them to the previously active one
393 // note that you don't have to call SetActiveTarget() with this class, it
394 // does it itself in its ctor
395 // ----------------------------------------------------------------------------
397 class WXDLLIMPEXP_BASE wxLogChain
: public wxLog
400 wxLogChain(wxLog
*logger
);
401 virtual ~wxLogChain();
403 // change the new log target
404 void SetLog(wxLog
*logger
);
406 // this can be used to temporarily disable (and then reenable) passing
407 // messages to the old logger (by default we do pass them)
408 void PassMessages(bool bDoPass
) { m_bPassMessages
= bDoPass
; }
410 // are we passing the messages to the previous log target?
411 bool IsPassingMessages() const { return m_bPassMessages
; }
413 // return the previous log target (may be NULL)
414 wxLog
*GetOldLog() const { return m_logOld
; }
416 // override base class version to flush the old logger as well
417 virtual void Flush();
420 // pass the chain to the old logger if needed
421 virtual void DoLog(wxLogLevel level
, const wxChar
*szString
, time_t t
);
424 // the current log target
427 // the previous log target
430 // do we pass the messages to the old logger?
431 bool m_bPassMessages
;
433 DECLARE_NO_COPY_CLASS(wxLogChain
)
436 // a chain log target which uses itself as the new logger
437 class WXDLLIMPEXP_BASE wxLogPassThrough
: public wxLogChain
443 DECLARE_NO_COPY_CLASS(wxLogPassThrough
)
447 // include GUI log targets:
448 #include "wx/generic/logg.h"
451 // ============================================================================
453 // ============================================================================
455 // ----------------------------------------------------------------------------
456 // Log functions should be used by application instead of stdio, iostream &c
457 // for log messages for easy redirection
458 // ----------------------------------------------------------------------------
460 // ----------------------------------------------------------------------------
461 // get error code/error message from system in a portable way
462 // ----------------------------------------------------------------------------
464 // return the last system error code
465 WXDLLIMPEXP_BASE
unsigned long wxSysErrorCode();
467 // return the error message for given (or last if 0) error code
468 WXDLLIMPEXP_BASE
const wxChar
* wxSysErrorMsg(unsigned long nErrCode
= 0);
470 // ----------------------------------------------------------------------------
471 // define wxLog<level>
472 // ----------------------------------------------------------------------------
474 #define DECLARE_LOG_FUNCTION(level) \
475 extern void WXDLLIMPEXP_BASE \
476 wxDoLog##level##Wchar(const wxChar *format, ...); \
477 extern void WXDLLIMPEXP_BASE \
478 wxDoLog##level##Utf8(const char *format, ...); \
479 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
480 1, (const wxString&), \
481 wxDoLog##level##Wchar, wxDoLog##level##Utf8) \
482 DECLARE_LOG_FUNCTION_WATCOM(level) \
483 extern void WXDLLIMPEXP_BASE wxVLog##level(const wxString& format, \
487 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351;
488 // can't use WX_WATCOM_ONLY_CODE here because the macro would expand to
489 // something too big for Borland C++ to handle
490 #define DECLARE_LOG_FUNCTION_WATCOM(level) \
491 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
493 wxDoLog##level##Wchar, \
494 wxDoLog##level##Utf8) \
495 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
496 1, (const wchar_t*), \
497 wxDoLog##level##Wchar, \
498 wxDoLog##level##Utf8) \
499 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
500 1, (const wxCStrData&), \
501 wxDoLog##level##Wchar, \
502 wxDoLog##level##Utf8)
504 #define DECLARE_LOG_FUNCTION_WATCOM(level)
508 #define DECLARE_LOG_FUNCTION2_EXP(level, argclass, arg, expdecl) \
509 extern void expdecl wxDoLog##level##Wchar(argclass arg, \
510 const wxChar *format, ...); \
511 extern void expdecl wxDoLog##level##Utf8(argclass arg, \
512 const char *format, ...); \
513 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
514 2, (argclass, const wxString&), \
515 wxDoLog##level##Wchar, wxDoLog##level##Utf8) \
516 DECLARE_LOG_FUNCTION2_EXP_WATCOM(level, argclass, arg, expdecl) \
517 extern void expdecl wxVLog##level(argclass arg, \
518 const wxString& format, \
522 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351;
523 // can't use WX_WATCOM_ONLY_CODE here because the macro would expand to
524 // something too big for Borland C++ to handle
525 #define DECLARE_LOG_FUNCTION2_EXP_WATCOM(level, argclass, arg, expdecl) \
526 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
527 2, (argclass, const char*), \
528 wxDoLog##level##Wchar, \
529 wxDoLog##level##Utf8) \
530 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
531 2, (argclass, const wchar_t*), \
532 wxDoLog##level##Wchar, \
533 wxDoLog##level##Utf8) \
534 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
535 2, (argclass, const wxCStrData&), \
536 wxDoLog##level##Wchar, \
537 wxDoLog##level##Utf8)
539 #define DECLARE_LOG_FUNCTION2_EXP_WATCOM(level, argclass, arg, expdecl)
546 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
547 #define WX_WATCOM_ONLY_CODE( x ) x
549 #define WX_WATCOM_ONLY_CODE( x )
552 // log functions do nothing at all
553 #define DECLARE_LOG_FUNCTION(level) \
554 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 1, (const wxString&)) \
555 WX_WATCOM_ONLY_CODE( \
556 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 1, (const char*)) \
557 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 1, (const wchar_t*)) \
558 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 1, (const wxCStrData&)) \
560 inline void wxVLog##level(const wxString& WXUNUSED(format), \
561 va_list WXUNUSED(argptr)) { } \
563 #define DECLARE_LOG_FUNCTION2_EXP(level, argclass, arg, expdecl) \
564 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 2, (argclass, const wxString&)) \
565 WX_WATCOM_ONLY_CODE( \
566 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 2, (argclass, const char*)) \
567 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 2, (argclass, const wchar_t*)) \
568 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 2, (argclass, const wxCStrData&)) \
570 inline void wxVLog##level(argclass WXUNUSED(arg), \
571 const wxString& WXUNUSED(format), \
572 va_list WXUNUSED(argptr)) {}
574 // Empty Class to fake wxLogNull
575 class WXDLLIMPEXP_BASE wxLogNull
581 // Dummy macros to replace some functions.
582 #define wxSysErrorCode() (unsigned long)0
583 #define wxSysErrorMsg( X ) (const wxChar*)NULL
585 // Fake symbolic trace masks... for those that are used frequently
586 #define wxTRACE_OleCalls wxEmptyString // OLE interface calls
588 #endif // wxUSE_LOG/!wxUSE_LOG
590 #define DECLARE_LOG_FUNCTION2(level, argclass, arg) \
591 DECLARE_LOG_FUNCTION2_EXP(level, argclass, arg, WXDLLIMPEXP_BASE)
593 // VC6 produces a warning if we a macro expanding to nothing to
594 // DECLARE_LOG_FUNCTION2:
595 #if defined(__VISUALC__) && __VISUALC__ < 1300
596 // "not enough actual parameters for macro 'DECLARE_LOG_FUNCTION2_EXP'"
597 #pragma warning(disable:4003)
600 // a generic function for all levels (level is passes as parameter)
601 DECLARE_LOG_FUNCTION2(Generic
, wxLogLevel
, level
);
603 // one function per each level
604 DECLARE_LOG_FUNCTION(FatalError
);
605 DECLARE_LOG_FUNCTION(Error
);
606 DECLARE_LOG_FUNCTION(Warning
);
607 DECLARE_LOG_FUNCTION(Message
);
608 DECLARE_LOG_FUNCTION(Info
);
609 DECLARE_LOG_FUNCTION(Verbose
);
611 // this function sends the log message to the status line of the top level
612 // application frame, if any
613 DECLARE_LOG_FUNCTION(Status
);
616 // this one is the same as previous except that it allows to explicitly
617 class WXDLLEXPORT wxFrame
;
618 // specify the frame to which the output should go
619 DECLARE_LOG_FUNCTION2_EXP(Status
, wxFrame
*, pFrame
, WXDLLIMPEXP_CORE
);
622 // additional one: as wxLogError, but also logs last system call error code
623 // and the corresponding error message if available
624 DECLARE_LOG_FUNCTION(SysError
);
626 // and another one which also takes the error code (for those broken APIs
627 // that don't set the errno (like registry APIs in Win32))
628 DECLARE_LOG_FUNCTION2(SysError
, long, lErrCode
);
630 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
631 DECLARE_LOG_FUNCTION2(SysError
, unsigned long, lErrCode
);
634 // debug functions do nothing in release mode
635 #if wxUSE_LOG && wxUSE_LOG_DEBUG
636 DECLARE_LOG_FUNCTION(Debug
);
638 // there is no more unconditional LogTrace: it is not different from
639 // LogDebug and it creates overload ambiguities
640 //DECLARE_LOG_FUNCTION(Trace);
642 // this version only logs the message if the mask had been added to the
643 // list of masks with AddTraceMask()
644 DECLARE_LOG_FUNCTION2(Trace
, const wxString
&, mask
);
646 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
647 DECLARE_LOG_FUNCTION2(Trace
, const char*, mask
);
648 DECLARE_LOG_FUNCTION2(Trace
, const wchar_t*, mask
);
651 // and this one does nothing if all of level bits are not set in
652 // wxLog::GetActive()->GetTraceMask() -- it's deprecated in favour of
653 // string identifiers
654 DECLARE_LOG_FUNCTION2(Trace
, wxTraceMask
, mask
);
656 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
657 DECLARE_LOG_FUNCTION2(Trace
, int, mask
);
659 #else //!debug || !wxUSE_LOG
660 // these functions do nothing in release builds, but don't define them as
661 // nothing as it could result in different code structure in debug and
662 // release and this could result in trouble when these macros are used
665 // note that making wxVLogDebug/Trace() themselves (empty inline) functions
666 // is a bad idea as some compilers are stupid enough to not inline even
667 // empty functions if their parameters are complicated enough, but by
668 // defining them as an empty inline function we ensure that even dumbest
669 // compilers optimise them away
670 inline void wxLogNop() { }
672 #define wxVLogDebug(fmt, valist) wxLogNop()
673 #define wxVLogTrace(mask, fmt, valist) wxLogNop()
675 #ifdef HAVE_VARIADIC_MACROS
676 // unlike the inline functions below, this completely removes the
677 // wxLogXXX calls from the object file:
678 #define wxLogDebug(fmt, ...) wxLogNop()
679 #define wxLogTrace(mask, fmt, ...) wxLogNop()
680 #else // !HAVE_VARIADIC_MACROS
681 //inline void wxLogDebug(const wxString& fmt, ...) {}
682 WX_DEFINE_VARARG_FUNC_NOP(wxLogDebug
, 1, (const wxString
&))
683 //inline void wxLogTrace(wxTraceMask, const wxString& fmt, ...) {}
684 //inline void wxLogTrace(const wxString&, const wxString& fmt, ...) {}
685 WX_DEFINE_VARARG_FUNC_NOP(wxLogTrace
, 2, (wxTraceMask
, const wxString
&))
686 WX_DEFINE_VARARG_FUNC_NOP(wxLogTrace
, 2, (const wxString
&, const wxString
&))
688 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
689 WX_DEFINE_VARARG_FUNC_NOP(wxLogTrace
, 2, (const char*, const char*))
690 WX_DEFINE_VARARG_FUNC_NOP(wxLogTrace
, 2, (const wchar_t*, const wchar_t*))
692 #endif // HAVE_VARIADIC_MACROS/!HAVE_VARIADIC_MACROS
693 #endif // debug/!debug
695 #if defined(__VISUALC__) && __VISUALC__ < 1300
696 #pragma warning(default:4003)
699 // wxLogFatalError helper: show the (fatal) error to the user in a safe way,
700 // i.e. without using wxMessageBox() for example because it could crash
701 void WXDLLIMPEXP_BASE
702 wxSafeShowMessage(const wxString
& title
, const wxString
& text
);
704 // ----------------------------------------------------------------------------
705 // debug only logging functions: use them with API name and error code
706 // ----------------------------------------------------------------------------
709 // make life easier for people using VC++ IDE: clicking on the message
710 // will take us immediately to the place of the failed API
712 #define wxLogApiError(api, rc) \
713 wxLogDebug(wxT("%s(%d): '%s' failed with error 0x%08lx (%s)."), \
714 __TFILE__, __LINE__, api, \
715 (long)rc, wxSysErrorMsg(rc))
717 #define wxLogApiError(api, rc) \
718 wxLogDebug(wxT("In file %s at line %d: '%s' failed with ") \
719 wxT("error 0x%08lx (%s)."), \
720 __TFILE__, __LINE__, api, \
721 (long)rc, wxSysErrorMsg(rc))
724 #define wxLogLastError(api) wxLogApiError(api, wxSysErrorCode())
727 #define wxLogApiError(api, err) wxLogNop()
728 #define wxLogLastError(api) wxLogNop()
729 #endif //debug/!debug
731 // wxCocoa has additiional trace masks
732 #if defined(__WXCOCOA__)
733 #include "wx/cocoa/log.h"
736 #ifdef WX_WATCOM_ONLY_CODE
737 #undef WX_WATCOM_ONLY_CODE