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 wxString
& 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 // Make GetActiveTarget() create a new log object again.
185 static void DoCreateOnDemand();
187 // log the count of repeating messages instead of logging the messages
189 static void SetRepetitionCounting(bool bRepetCounting
= true)
190 { ms_bRepetCounting
= bRepetCounting
; }
192 // gets duplicate counting status
193 static bool GetRepetitionCounting() { return ms_bRepetCounting
; }
195 // trace mask (see wxTraceXXX constants for details)
196 static void SetTraceMask(wxTraceMask ulMask
) { ms_ulTraceMask
= ulMask
; }
198 // add string trace mask
199 static void AddTraceMask(const wxString
& str
)
200 { ms_aTraceMasks
.push_back(str
); }
202 // add string trace mask
203 static void RemoveTraceMask(const wxString
& str
);
205 // remove all string trace masks
206 static void ClearTraceMasks();
208 // get string trace masks
209 static const wxArrayString
&GetTraceMasks() { return ms_aTraceMasks
; }
211 // sets the timestamp string: this is used as strftime() format string
212 // for the log targets which add time stamps to the messages - set it
213 // to NULL to disable time stamping completely.
214 static void SetTimestamp(const wxChar
*ts
) { ms_timestamp
= ts
; }
219 // gets the verbose status
220 static bool GetVerbose() { return ms_bVerbose
; }
223 static wxTraceMask
GetTraceMask() { return ms_ulTraceMask
; }
225 // is this trace mask in the list?
226 static bool IsAllowedTraceMask(const wxString
& mask
);
228 // return the current loglevel limit
229 static wxLogLevel
GetLogLevel() { return ms_logLevel
; }
231 // get the current timestamp format string (may be NULL)
232 static const wxChar
*GetTimestamp() { return ms_timestamp
; }
237 // put the time stamp into the string if ms_timestamp != NULL (don't
238 // change it otherwise)
239 static void TimeStamp(wxString
*str
);
241 // make dtor virtual for all derived classes
245 // this method exists for backwards compatibility only, don't use
246 bool HasPendingMessages() const { return true; }
248 #if WXWIN_COMPATIBILITY_2_6
249 // this function doesn't do anything any more, don't call it
250 wxDEPRECATED( static wxChar
*SetLogBuffer(wxChar
*buf
, size_t size
= 0) );
254 // the logging functions that can be overriden
256 // default DoLog() prepends the time stamp and a prefix corresponding
257 // to the message to szString and then passes it to DoLogString()
258 virtual void DoLog(wxLogLevel level
, const wxString
& szString
, time_t t
);
259 #if WXWIN_COMPATIBILITY_2_8
260 // these shouldn't be used by new code
261 virtual void DoLog(wxLogLevel
WXUNUSED(level
),
262 const char *WXUNUSED(szString
), time_t WXUNUSED(t
)) {}
263 virtual void DoLog(wxLogLevel
WXUNUSED(level
),
264 const wchar_t *WXUNUSED(szString
), time_t WXUNUSED(t
)) {}
267 void LogString(const wxString
& szString
, time_t t
)
268 { DoLogString(szString
, t
); }
270 // default DoLogString does nothing but is not pure virtual because if
271 // you override DoLog() you might not need it at all
272 virtual void DoLogString(const wxString
& szString
, time_t t
);
273 #if WXWIN_COMPATIBILITY_2_8
274 // these shouldn't be used by new code
275 virtual void DoLogString(const char *WXUNUSED(szString
),
276 time_t WXUNUSED(t
)) {}
277 virtual void DoLogString(const wchar_t *WXUNUSED(szString
),
278 time_t WXUNUSED(t
)) {}
281 // log a line containing the number of times the previous message was
283 // returns: the number
284 static unsigned DoLogNumberOfRepeats();
290 // traditional behaviour or counting repetitions
291 static bool ms_bRepetCounting
;
292 static wxString ms_prevString
; // previous message that was logged
293 // how many times the previous message was logged
294 static unsigned ms_prevCounter
;
295 static time_t ms_prevTimeStamp
;// timestamp of the previous message
296 static wxLogLevel ms_prevLevel
; // level of the previous message
298 static wxLog
*ms_pLogger
; // currently active log sink
299 static bool ms_doLog
; // false => all logging disabled
300 static bool ms_bAutoCreate
; // create new log targets on demand?
301 static bool ms_bVerbose
; // false => ignore LogInfo messages
303 static wxLogLevel ms_logLevel
; // limit logging to levels <= ms_logLevel
305 static size_t ms_suspendCount
; // if positive, logs are not flushed
307 // format string for strftime(), if NULL, time stamping log messages is
309 static const wxChar
*ms_timestamp
;
311 static wxTraceMask ms_ulTraceMask
; // controls wxLogTrace behaviour
312 static wxArrayString ms_aTraceMasks
; // more powerful filter for wxLogTrace
315 // ----------------------------------------------------------------------------
316 // "trivial" derivations of wxLog
317 // ----------------------------------------------------------------------------
319 // log everything to a buffer
320 class WXDLLIMPEXP_BASE wxLogBuffer
: public wxLog
325 // get the string contents with all messages logged
326 const wxString
& GetBuffer() const { return m_str
; }
328 // show the buffer contents to the user in the best possible way (this uses
329 // wxMessageOutputMessageBox) and clear it
330 virtual void Flush();
333 virtual void DoLog(wxLogLevel level
, const wxString
& szString
, time_t t
);
334 virtual void DoLogString(const wxString
& szString
, time_t t
);
339 DECLARE_NO_COPY_CLASS(wxLogBuffer
)
343 // log everything to a "FILE *", stderr by default
344 class WXDLLIMPEXP_BASE wxLogStderr
: public wxLog
347 // redirect log output to a FILE
348 wxLogStderr(FILE *fp
= (FILE *) NULL
);
351 // implement sink function
352 virtual void DoLogString(const wxString
& szString
, time_t t
);
356 DECLARE_NO_COPY_CLASS(wxLogStderr
)
359 #if wxUSE_STD_IOSTREAM
361 // log everything to an "ostream", cerr by default
362 class WXDLLIMPEXP_BASE wxLogStream
: public wxLog
365 // redirect log output to an ostream
366 wxLogStream(wxSTD ostream
*ostr
= (wxSTD ostream
*) NULL
);
369 // implement sink function
370 virtual void DoLogString(const wxString
& szString
, time_t t
);
372 // using ptr here to avoid including <iostream.h> from this file
373 wxSTD ostream
*m_ostr
;
376 #endif // wxUSE_STD_IOSTREAM
378 // ----------------------------------------------------------------------------
379 // /dev/null log target: suppress logging until this object goes out of scope
380 // ----------------------------------------------------------------------------
388 // wxFile.Open() normally complains if file can't be opened, we don't
392 if ( !file.Open("bar") )
393 ... process error ourselves ...
395 // ~wxLogNull called, old log sink restored
398 class WXDLLIMPEXP_BASE wxLogNull
401 wxLogNull() : m_flagOld(wxLog::EnableLogging(false)) { }
402 ~wxLogNull() { (void)wxLog::EnableLogging(m_flagOld
); }
405 bool m_flagOld
; // the previous value of the wxLog::ms_doLog
408 // ----------------------------------------------------------------------------
409 // chaining log target: installs itself as a log target and passes all
410 // messages to the real log target given to it in the ctor but also forwards
411 // them to the previously active one
413 // note that you don't have to call SetActiveTarget() with this class, it
414 // does it itself in its ctor
415 // ----------------------------------------------------------------------------
417 class WXDLLIMPEXP_BASE wxLogChain
: public wxLog
420 wxLogChain(wxLog
*logger
);
421 virtual ~wxLogChain();
423 // change the new log target
424 void SetLog(wxLog
*logger
);
426 // this can be used to temporarily disable (and then reenable) passing
427 // messages to the old logger (by default we do pass them)
428 void PassMessages(bool bDoPass
) { m_bPassMessages
= bDoPass
; }
430 // are we passing the messages to the previous log target?
431 bool IsPassingMessages() const { return m_bPassMessages
; }
433 // return the previous log target (may be NULL)
434 wxLog
*GetOldLog() const { return m_logOld
; }
436 // override base class version to flush the old logger as well
437 virtual void Flush();
440 // pass the chain to the old logger if needed
441 virtual void DoLog(wxLogLevel level
, const wxString
& szString
, time_t t
);
444 // the current log target
447 // the previous log target
450 // do we pass the messages to the old logger?
451 bool m_bPassMessages
;
453 DECLARE_NO_COPY_CLASS(wxLogChain
)
456 // a chain log target which uses itself as the new logger
457 class WXDLLIMPEXP_BASE wxLogPassThrough
: public wxLogChain
463 DECLARE_NO_COPY_CLASS(wxLogPassThrough
)
467 // include GUI log targets:
468 #include "wx/generic/logg.h"
471 // ============================================================================
473 // ============================================================================
475 // ----------------------------------------------------------------------------
476 // Log functions should be used by application instead of stdio, iostream &c
477 // for log messages for easy redirection
478 // ----------------------------------------------------------------------------
480 // ----------------------------------------------------------------------------
481 // get error code/error message from system in a portable way
482 // ----------------------------------------------------------------------------
484 // return the last system error code
485 WXDLLIMPEXP_BASE
unsigned long wxSysErrorCode();
487 // return the error message for given (or last if 0) error code
488 WXDLLIMPEXP_BASE
const wxChar
* wxSysErrorMsg(unsigned long nErrCode
= 0);
490 // ----------------------------------------------------------------------------
491 // define wxLog<level>
492 // ----------------------------------------------------------------------------
494 #define DECLARE_LOG_FUNCTION(level) \
495 extern void WXDLLIMPEXP_BASE \
496 wxDoLog##level##Wchar(const wxChar *format, ...); \
497 extern void WXDLLIMPEXP_BASE \
498 wxDoLog##level##Utf8(const char *format, ...); \
499 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
500 1, (const wxFormatString&), \
501 wxDoLog##level##Wchar, wxDoLog##level##Utf8) \
502 DECLARE_LOG_FUNCTION_WATCOM(level) \
503 extern void WXDLLIMPEXP_BASE wxVLog##level(const wxString& format, \
507 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351;
508 // can't use WX_WATCOM_ONLY_CODE here because the macro would expand to
509 // something too big for Borland C++ to handle
510 #define DECLARE_LOG_FUNCTION_WATCOM(level) \
511 WX_VARARG_WATCOM_WORKAROUND(void, wxLog##level, \
512 1, (const wxString&), \
513 (wxFormatString(f1))) \
514 WX_VARARG_WATCOM_WORKAROUND(void, wxLog##level, \
515 1, (const wxCStrData&), \
516 (wxFormatString(f1))) \
517 WX_VARARG_WATCOM_WORKAROUND(void, wxLog##level, \
519 (wxFormatString(f1))) \
520 WX_VARARG_WATCOM_WORKAROUND(void, wxLog##level, \
521 1, (const wchar_t*), \
522 (wxFormatString(f1)))
524 #define DECLARE_LOG_FUNCTION_WATCOM(level)
528 #define DECLARE_LOG_FUNCTION2_EXP(level, argclass, arg, expdecl) \
529 extern void expdecl wxDoLog##level##Wchar(argclass arg, \
530 const wxChar *format, ...); \
531 extern void expdecl wxDoLog##level##Utf8(argclass arg, \
532 const char *format, ...); \
533 WX_DEFINE_VARARG_FUNC_VOID(wxLog##level, \
534 2, (argclass, const wxFormatString&), \
535 wxDoLog##level##Wchar, wxDoLog##level##Utf8) \
536 DECLARE_LOG_FUNCTION2_EXP_WATCOM(level, argclass, arg, expdecl) \
537 extern void expdecl wxVLog##level(argclass arg, \
538 const wxString& format, \
542 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351;
543 // can't use WX_WATCOM_ONLY_CODE here because the macro would expand to
544 // something too big for Borland C++ to handle
545 #define DECLARE_LOG_FUNCTION2_EXP_WATCOM(level, argclass, arg, expdecl) \
546 WX_VARARG_WATCOM_WORKAROUND(void, wxLog##level, \
547 2, (argclass, const wxString&), \
548 (f1, wxFormatString(f2))) \
549 WX_VARARG_WATCOM_WORKAROUND(void, wxLog##level, \
550 2, (argclass, const wxCStrData&), \
551 (f1, wxFormatString(f2))) \
552 WX_VARARG_WATCOM_WORKAROUND(void, wxLog##level, \
553 2, (argclass, const char*), \
554 (f1, wxFormatString(f2))) \
555 WX_VARARG_WATCOM_WORKAROUND(void, wxLog##level, \
556 2, (argclass, const wchar_t*), \
557 (f1, wxFormatString(f2)))
559 #define DECLARE_LOG_FUNCTION2_EXP_WATCOM(level, argclass, arg, expdecl)
566 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
567 #define WX_WATCOM_ONLY_CODE( x ) x
569 #define WX_WATCOM_ONLY_CODE( x )
572 // log functions do nothing at all
573 #define DECLARE_LOG_FUNCTION(level) \
574 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 1, (const wxString&)) \
575 WX_WATCOM_ONLY_CODE( \
576 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 1, (const char*)) \
577 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 1, (const wchar_t*)) \
578 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 1, (const wxCStrData&)) \
580 inline void wxVLog##level(const wxString& WXUNUSED(format), \
581 va_list WXUNUSED(argptr)) { } \
583 #define DECLARE_LOG_FUNCTION2_EXP(level, argclass, arg, expdecl) \
584 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 2, (argclass, const wxString&)) \
585 WX_WATCOM_ONLY_CODE( \
586 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 2, (argclass, const char*)) \
587 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 2, (argclass, const wchar_t*)) \
588 WX_DEFINE_VARARG_FUNC_NOP(wxLog##level, 2, (argclass, const wxCStrData&)) \
590 inline void wxVLog##level(argclass WXUNUSED(arg), \
591 const wxString& WXUNUSED(format), \
592 va_list WXUNUSED(argptr)) {}
594 // Empty Class to fake wxLogNull
595 class WXDLLIMPEXP_BASE wxLogNull
601 // Dummy macros to replace some functions.
602 #define wxSysErrorCode() (unsigned long)0
603 #define wxSysErrorMsg( X ) (const wxChar*)NULL
605 // Fake symbolic trace masks... for those that are used frequently
606 #define wxTRACE_OleCalls wxEmptyString // OLE interface calls
608 #endif // wxUSE_LOG/!wxUSE_LOG
610 #define DECLARE_LOG_FUNCTION2(level, argclass, arg) \
611 DECLARE_LOG_FUNCTION2_EXP(level, argclass, arg, WXDLLIMPEXP_BASE)
613 // VC6 produces a warning if we a macro expanding to nothing to
614 // DECLARE_LOG_FUNCTION2:
615 #if defined(__VISUALC__) && __VISUALC__ < 1300
616 // "not enough actual parameters for macro 'DECLARE_LOG_FUNCTION2_EXP'"
617 #pragma warning(disable:4003)
620 // a generic function for all levels (level is passes as parameter)
621 DECLARE_LOG_FUNCTION2(Generic
, wxLogLevel
, level
);
623 // one function per each level
624 DECLARE_LOG_FUNCTION(FatalError
);
625 DECLARE_LOG_FUNCTION(Error
);
626 DECLARE_LOG_FUNCTION(Warning
);
627 DECLARE_LOG_FUNCTION(Message
);
628 DECLARE_LOG_FUNCTION(Info
);
629 DECLARE_LOG_FUNCTION(Verbose
);
631 // this function sends the log message to the status line of the top level
632 // application frame, if any
633 DECLARE_LOG_FUNCTION(Status
);
636 // this one is the same as previous except that it allows to explicitly
637 class WXDLLEXPORT wxFrame
;
638 // specify the frame to which the output should go
639 DECLARE_LOG_FUNCTION2_EXP(Status
, wxFrame
*, pFrame
, WXDLLIMPEXP_CORE
);
642 // additional one: as wxLogError, but also logs last system call error code
643 // and the corresponding error message if available
644 DECLARE_LOG_FUNCTION(SysError
);
646 // and another one which also takes the error code (for those broken APIs
647 // that don't set the errno (like registry APIs in Win32))
648 DECLARE_LOG_FUNCTION2(SysError
, long, lErrCode
);
650 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
651 DECLARE_LOG_FUNCTION2(SysError
, unsigned long, lErrCode
);
654 // debug functions do nothing in release mode
655 #if wxUSE_LOG && wxUSE_LOG_DEBUG
656 DECLARE_LOG_FUNCTION(Debug
);
658 // there is no more unconditional LogTrace: it is not different from
659 // LogDebug and it creates overload ambiguities
660 //DECLARE_LOG_FUNCTION(Trace);
662 // this version only logs the message if the mask had been added to the
663 // list of masks with AddTraceMask()
664 DECLARE_LOG_FUNCTION2(Trace
, const wxString
&, mask
);
666 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
667 DECLARE_LOG_FUNCTION2(Trace
, const char*, mask
);
668 DECLARE_LOG_FUNCTION2(Trace
, const wchar_t*, mask
);
671 // and this one does nothing if all of level bits are not set in
672 // wxLog::GetActive()->GetTraceMask() -- it's deprecated in favour of
673 // string identifiers
674 DECLARE_LOG_FUNCTION2(Trace
, wxTraceMask
, mask
);
676 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
677 DECLARE_LOG_FUNCTION2(Trace
, int, mask
);
679 #else //!debug || !wxUSE_LOG
680 // these functions do nothing in release builds, but don't define them as
681 // nothing as it could result in different code structure in debug and
682 // release and this could result in trouble when these macros are used
685 // note that making wxVLogDebug/Trace() themselves (empty inline) functions
686 // is a bad idea as some compilers are stupid enough to not inline even
687 // empty functions if their parameters are complicated enough, but by
688 // defining them as an empty inline function we ensure that even dumbest
689 // compilers optimise them away
690 inline void wxLogNop() { }
692 #define wxVLogDebug(fmt, valist) wxLogNop()
693 #define wxVLogTrace(mask, fmt, valist) wxLogNop()
695 #ifdef HAVE_VARIADIC_MACROS
696 // unlike the inline functions below, this completely removes the
697 // wxLogXXX calls from the object file:
698 #define wxLogDebug(fmt, ...) wxLogNop()
699 #define wxLogTrace(mask, fmt, ...) wxLogNop()
700 #else // !HAVE_VARIADIC_MACROS
701 //inline void wxLogDebug(const wxString& fmt, ...) {}
702 WX_DEFINE_VARARG_FUNC_NOP(wxLogDebug
, 1, (const wxString
&))
703 //inline void wxLogTrace(wxTraceMask, const wxString& fmt, ...) {}
704 //inline void wxLogTrace(const wxString&, const wxString& fmt, ...) {}
705 WX_DEFINE_VARARG_FUNC_NOP(wxLogTrace
, 2, (wxTraceMask
, const wxString
&))
706 WX_DEFINE_VARARG_FUNC_NOP(wxLogTrace
, 2, (const wxString
&, const wxString
&))
708 // workaround for http://bugzilla.openwatcom.org/show_bug.cgi?id=351
709 WX_DEFINE_VARARG_FUNC_NOP(wxLogTrace
, 2, (const char*, const char*))
710 WX_DEFINE_VARARG_FUNC_NOP(wxLogTrace
, 2, (const wchar_t*, const wchar_t*))
712 #endif // HAVE_VARIADIC_MACROS/!HAVE_VARIADIC_MACROS
713 #endif // debug/!debug
715 #if defined(__VISUALC__) && __VISUALC__ < 1300
716 #pragma warning(default:4003)
719 // wxLogFatalError helper: show the (fatal) error to the user in a safe way,
720 // i.e. without using wxMessageBox() for example because it could crash
721 void WXDLLIMPEXP_BASE
722 wxSafeShowMessage(const wxString
& title
, const wxString
& text
);
724 // ----------------------------------------------------------------------------
725 // debug only logging functions: use them with API name and error code
726 // ----------------------------------------------------------------------------
729 // make life easier for people using VC++ IDE: clicking on the message
730 // will take us immediately to the place of the failed API
732 #define wxLogApiError(api, rc) \
733 wxLogDebug(wxT("%s(%d): '%s' failed with error 0x%08lx (%s)."), \
734 __FILE__, __LINE__, api, \
735 (long)rc, wxSysErrorMsg(rc))
737 #define wxLogApiError(api, rc) \
738 wxLogDebug(wxT("In file %s at line %d: '%s' failed with ") \
739 wxT("error 0x%08lx (%s)."), \
740 __FILE__, __LINE__, api, \
741 (long)rc, wxSysErrorMsg(rc))
744 #define wxLogLastError(api) wxLogApiError(api, wxSysErrorCode())
747 #define wxLogApiError(api, err) wxLogNop()
748 #define wxLogLastError(api) wxLogNop()
749 #endif //debug/!debug
751 // wxCocoa has additiional trace masks
752 #if defined(__WXCOCOA__)
753 #include "wx/cocoa/log.h"
756 #ifdef WX_WATCOM_ONLY_CODE
757 #undef WX_WATCOM_ONLY_CODE