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 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
21 #pragma implementation "log.h"
24 // For compilers that support precompilation, includes "wx.h".
25 #include "wx/wxprec.h"
36 #include "wx/arrstr.h"
38 #include "wx/string.h"
41 #include "wx/apptrait.h"
44 #include "wx/msgout.h"
45 #include "wx/textfile.h"
46 #include "wx/thread.h"
48 #include "wx/wxchar.h"
50 // other standard headers
60 #include "wx/msw/wince/time.h"
63 #if defined(__WINDOWS__)
64 #include "wx/msw/private.h" // includes windows.h
67 // ----------------------------------------------------------------------------
68 // non member functions
69 // ----------------------------------------------------------------------------
71 // define this to enable wrapping of log messages
72 //#define LOG_PRETTY_WRAP
74 #ifdef LOG_PRETTY_WRAP
75 static void wxLogWrap(FILE *f
, const char *pszPrefix
, const char *psz
);
78 // ============================================================================
80 // ============================================================================
82 // ----------------------------------------------------------------------------
84 // ----------------------------------------------------------------------------
86 // log functions can't allocate memory (LogError("out of memory...") should
87 // work!), so we use a static buffer for all log messages
88 #define LOG_BUFFER_SIZE (4096)
90 // static buffer for error messages
91 static wxChar s_szBufStatic
[LOG_BUFFER_SIZE
];
93 static wxChar
*s_szBuf
= s_szBufStatic
;
94 static size_t s_szBufSize
= WXSIZEOF( s_szBufStatic
);
98 // the critical section protecting the static buffer
99 static wxCriticalSection gs_csLogBuf
;
101 #endif // wxUSE_THREADS
103 // return true if we have a non NULL non disabled log target
104 static inline bool IsLoggingEnabled()
106 return wxLog::IsEnabled() && (wxLog::GetActiveTarget() != NULL
);
109 // ----------------------------------------------------------------------------
110 // implementation of Log functions
112 // NB: unfortunately we need all these distinct functions, we can't make them
113 // macros and not all compilers inline vararg functions.
114 // ----------------------------------------------------------------------------
116 // wrapper for wxVsnprintf(s_szBuf) which always NULL-terminates it
117 static inline void PrintfInLogBug(const wxChar
*szFormat
, va_list argptr
)
119 if ( wxVsnprintf(s_szBuf
, s_szBufSize
, szFormat
, argptr
) < 0 )
121 // must NUL-terminate it manually
122 s_szBuf
[s_szBufSize
- 1] = _T('\0');
124 //else: NUL-terminated by vsnprintf()
127 // generic log function
128 void wxVLogGeneric(wxLogLevel level
, const wxChar
*szFormat
, va_list argptr
)
130 if ( IsLoggingEnabled() ) {
131 wxCRIT_SECT_LOCKER(locker
, gs_csLogBuf
);
133 PrintfInLogBug(szFormat
, argptr
);
135 wxLog::OnLog(level
, s_szBuf
, time(NULL
));
139 void wxLogGeneric(wxLogLevel level
, const wxChar
*szFormat
, ...)
142 va_start(argptr
, szFormat
);
143 wxVLogGeneric(level
, szFormat
, argptr
);
147 #define IMPLEMENT_LOG_FUNCTION(level) \
148 void wxVLog##level(const wxChar *szFormat, va_list argptr) \
150 if ( IsLoggingEnabled() ) { \
151 wxCRIT_SECT_LOCKER(locker, gs_csLogBuf); \
153 PrintfInLogBug(szFormat, argptr); \
155 wxLog::OnLog(wxLOG_##level, s_szBuf, time(NULL)); \
159 void wxLog##level(const wxChar *szFormat, ...) \
162 va_start(argptr, szFormat); \
163 wxVLog##level(szFormat, argptr); \
167 IMPLEMENT_LOG_FUNCTION(Error
)
168 IMPLEMENT_LOG_FUNCTION(Warning
)
169 IMPLEMENT_LOG_FUNCTION(Message
)
170 IMPLEMENT_LOG_FUNCTION(Info
)
171 IMPLEMENT_LOG_FUNCTION(Status
)
173 void wxSafeShowMessage(const wxString
& title
, const wxString
& text
)
176 ::MessageBox(NULL
, text
, title
, MB_OK
| MB_ICONSTOP
);
178 wxFprintf(stderr
, _T("%s: %s\n"), title
.c_str(), text
.c_str());
182 // fatal errors can't be suppressed nor handled by the custom log target and
183 // always terminate the program
184 void wxVLogFatalError(const wxChar
*szFormat
, va_list argptr
)
186 wxVsnprintf(s_szBuf
, s_szBufSize
, szFormat
, argptr
);
188 wxSafeShowMessage(_T("Fatal Error"), s_szBuf
);
197 void wxLogFatalError(const wxChar
*szFormat
, ...)
200 va_start(argptr
, szFormat
);
201 wxVLogFatalError(szFormat
, argptr
);
203 // some compilers warn about unreachable code and it shouldn't matter
204 // for the others anyhow...
208 // same as info, but only if 'verbose' mode is on
209 void wxVLogVerbose(const wxChar
*szFormat
, va_list argptr
)
211 if ( IsLoggingEnabled() ) {
212 wxLog
*pLog
= wxLog::GetActiveTarget();
213 if ( pLog
!= NULL
&& pLog
->GetVerbose() ) {
214 wxCRIT_SECT_LOCKER(locker
, gs_csLogBuf
);
216 wxVsnprintf(s_szBuf
, s_szBufSize
, szFormat
, argptr
);
218 wxLog::OnLog(wxLOG_Info
, s_szBuf
, time(NULL
));
223 void wxLogVerbose(const wxChar
*szFormat
, ...)
226 va_start(argptr
, szFormat
);
227 wxVLogVerbose(szFormat
, argptr
);
233 #define IMPLEMENT_LOG_DEBUG_FUNCTION(level) \
234 void wxVLog##level(const wxChar *szFormat, va_list argptr) \
236 if ( IsLoggingEnabled() ) { \
237 wxCRIT_SECT_LOCKER(locker, gs_csLogBuf); \
239 wxVsnprintf(s_szBuf, s_szBufSize, szFormat, argptr); \
241 wxLog::OnLog(wxLOG_##level, s_szBuf, time(NULL)); \
244 void wxLog##level(const wxChar *szFormat, ...) \
247 va_start(argptr, szFormat); \
248 wxVLog##level(szFormat, argptr); \
252 void wxVLogTrace(const wxChar
*mask
, const wxChar
*szFormat
, va_list argptr
)
254 if ( IsLoggingEnabled() && wxLog::IsAllowedTraceMask(mask
) ) {
255 wxCRIT_SECT_LOCKER(locker
, gs_csLogBuf
);
258 size_t len
= s_szBufSize
;
259 wxStrncpy(s_szBuf
, _T("("), len
);
260 len
-= 1; // strlen("(")
262 wxStrncat(p
, mask
, len
);
263 size_t lenMask
= wxStrlen(mask
);
267 wxStrncat(p
, _T(") "), len
);
271 wxVsnprintf(p
, len
, szFormat
, argptr
);
273 wxLog::OnLog(wxLOG_Trace
, s_szBuf
, time(NULL
));
277 void wxLogTrace(const wxChar
*mask
, const wxChar
*szFormat
, ...)
280 va_start(argptr
, szFormat
);
281 wxVLogTrace(mask
, szFormat
, argptr
);
285 void wxVLogTrace(wxTraceMask mask
, const wxChar
*szFormat
, va_list argptr
)
287 // we check that all of mask bits are set in the current mask, so
288 // that wxLogTrace(wxTraceRefCount | wxTraceOle) will only do something
289 // if both bits are set.
290 if ( IsLoggingEnabled() && ((wxLog::GetTraceMask() & mask
) == mask
) ) {
291 wxCRIT_SECT_LOCKER(locker
, gs_csLogBuf
);
293 wxVsnprintf(s_szBuf
, s_szBufSize
, szFormat
, argptr
);
295 wxLog::OnLog(wxLOG_Trace
, s_szBuf
, time(NULL
));
299 void wxLogTrace(wxTraceMask mask
, const wxChar
*szFormat
, ...)
302 va_start(argptr
, szFormat
);
303 wxVLogTrace(mask
, szFormat
, argptr
);
308 #define IMPLEMENT_LOG_DEBUG_FUNCTION(level)
311 IMPLEMENT_LOG_DEBUG_FUNCTION(Debug
)
312 IMPLEMENT_LOG_DEBUG_FUNCTION(Trace
)
314 // wxLogSysError: one uses the last error code, for other you must give it
317 // common part of both wxLogSysError
318 void wxLogSysErrorHelper(long lErrCode
)
320 wxChar szErrMsg
[LOG_BUFFER_SIZE
/ 2];
321 wxSnprintf(szErrMsg
, WXSIZEOF(szErrMsg
),
322 _(" (error %ld: %s)"), lErrCode
, wxSysErrorMsg(lErrCode
));
323 wxStrncat(s_szBuf
, szErrMsg
, s_szBufSize
- wxStrlen(s_szBuf
));
325 wxLog::OnLog(wxLOG_Error
, s_szBuf
, time(NULL
));
328 void WXDLLEXPORT
wxVLogSysError(const wxChar
*szFormat
, va_list argptr
)
330 if ( IsLoggingEnabled() ) {
331 wxCRIT_SECT_LOCKER(locker
, gs_csLogBuf
);
333 wxVsnprintf(s_szBuf
, s_szBufSize
, szFormat
, argptr
);
335 wxLogSysErrorHelper(wxSysErrorCode());
339 void WXDLLEXPORT
wxLogSysError(const wxChar
*szFormat
, ...)
342 va_start(argptr
, szFormat
);
343 wxVLogSysError(szFormat
, argptr
);
347 void WXDLLEXPORT
wxVLogSysError(long lErrCode
, const wxChar
*szFormat
, va_list argptr
)
349 if ( IsLoggingEnabled() ) {
350 wxCRIT_SECT_LOCKER(locker
, gs_csLogBuf
);
352 wxVsnprintf(s_szBuf
, s_szBufSize
, szFormat
, argptr
);
354 wxLogSysErrorHelper(lErrCode
);
358 void WXDLLEXPORT
wxLogSysError(long lErrCode
, const wxChar
*szFormat
, ...)
361 va_start(argptr
, szFormat
);
362 wxVLogSysError(lErrCode
, szFormat
, argptr
);
366 // ----------------------------------------------------------------------------
367 // wxLog class implementation
368 // ----------------------------------------------------------------------------
370 wxChar
*wxLog::SetLogBuffer( wxChar
*buf
, size_t size
)
372 wxChar
*oldbuf
= s_szBuf
;
376 s_szBuf
= s_szBufStatic
;
377 s_szBufSize
= WXSIZEOF( s_szBufStatic
);
385 return (oldbuf
== s_szBufStatic
) ? 0 : oldbuf
;
388 wxLog
*wxLog::GetActiveTarget()
390 if ( ms_bAutoCreate
&& ms_pLogger
== NULL
) {
391 // prevent infinite recursion if someone calls wxLogXXX() from
392 // wxApp::CreateLogTarget()
393 static bool s_bInGetActiveTarget
= false;
394 if ( !s_bInGetActiveTarget
) {
395 s_bInGetActiveTarget
= true;
397 // ask the application to create a log target for us
398 if ( wxTheApp
!= NULL
)
399 ms_pLogger
= wxTheApp
->GetTraits()->CreateLogTarget();
401 ms_pLogger
= new wxLogStderr
;
403 s_bInGetActiveTarget
= false;
405 // do nothing if it fails - what can we do?
412 wxLog
*wxLog::SetActiveTarget(wxLog
*pLogger
)
414 if ( ms_pLogger
!= NULL
) {
415 // flush the old messages before changing because otherwise they might
416 // get lost later if this target is not restored
420 wxLog
*pOldLogger
= ms_pLogger
;
421 ms_pLogger
= pLogger
;
426 void wxLog::DontCreateOnDemand()
428 ms_bAutoCreate
= false;
430 // this is usually called at the end of the program and we assume that it
431 // is *always* called at the end - so we free memory here to avoid false
432 // memory leak reports from wxWin memory tracking code
436 void wxLog::RemoveTraceMask(const wxString
& str
)
438 int index
= ms_aTraceMasks
.Index(str
);
439 if ( index
!= wxNOT_FOUND
)
440 ms_aTraceMasks
.RemoveAt((size_t)index
);
443 void wxLog::ClearTraceMasks()
445 ms_aTraceMasks
.Clear();
448 void wxLog::TimeStamp(wxString
*str
)
454 (void)time(&timeNow
);
455 wxStrftime(buf
, WXSIZEOF(buf
), ms_timestamp
, localtime(&timeNow
));
458 *str
<< buf
<< wxT(": ");
462 void wxLog::DoLog(wxLogLevel level
, const wxChar
*szString
, time_t t
)
465 case wxLOG_FatalError
:
466 DoLogString(wxString(_("Fatal error: ")) + szString
, t
);
467 DoLogString(_("Program aborted."), t
);
477 DoLogString(wxString(_("Error: ")) + szString
, t
);
481 DoLogString(wxString(_("Warning: ")) + szString
, t
);
488 default: // log unknown log levels too
489 DoLogString(szString
, t
);
496 wxString msg
= level
== wxLOG_Trace
? wxT("Trace: ")
506 void wxLog::DoLogString(const wxChar
*WXUNUSED(szString
), time_t WXUNUSED(t
))
508 wxFAIL_MSG(wxT("DoLogString must be overriden if it's called."));
513 // nothing to do here
516 /*static*/ bool wxLog::IsAllowedTraceMask(const wxChar
*mask
)
518 for ( wxArrayString::iterator it
= ms_aTraceMasks
.begin(),
519 en
= ms_aTraceMasks
.end();
526 // ----------------------------------------------------------------------------
527 // wxLogStderr class implementation
528 // ----------------------------------------------------------------------------
530 wxLogStderr::wxLogStderr(FILE *fp
)
538 void wxLogStderr::DoLogString(const wxChar
*szString
, time_t WXUNUSED(t
))
544 fputs(str
.mb_str(), m_fp
);
545 fputc(_T('\n'), m_fp
);
548 // under GUI systems such as Windows or Mac, programs usually don't have
549 // stderr at all, so show the messages also somewhere else, typically in
550 // the debugger window so that they go at least somewhere instead of being
552 if ( m_fp
== stderr
)
554 wxAppTraits
*traits
= wxTheApp
? wxTheApp
->GetTraits() : NULL
;
555 if ( traits
&& !traits
->HasStderr() )
557 wxMessageOutputDebug dbgout
;
558 dbgout
.Printf(_T("%s\n"), str
.c_str());
563 // ----------------------------------------------------------------------------
564 // wxLogStream implementation
565 // ----------------------------------------------------------------------------
567 #if wxUSE_STD_IOSTREAM
568 #include "wx/ioswrap.h"
569 wxLogStream::wxLogStream(wxSTD ostream
*ostr
)
572 m_ostr
= &wxSTD cerr
;
577 void wxLogStream::DoLogString(const wxChar
*szString
, time_t WXUNUSED(t
))
581 (*m_ostr
) << str
<< wxConvertWX2MB(szString
) << wxSTD endl
;
583 #endif // wxUSE_STD_IOSTREAM
585 // ----------------------------------------------------------------------------
587 // ----------------------------------------------------------------------------
589 wxLogChain::wxLogChain(wxLog
*logger
)
591 m_bPassMessages
= true;
594 m_logOld
= wxLog::SetActiveTarget(this);
597 wxLogChain::~wxLogChain()
601 if ( m_logNew
!= this )
605 void wxLogChain::SetLog(wxLog
*logger
)
607 if ( m_logNew
!= this )
613 void wxLogChain::Flush()
618 // be careful to avoid infinite recursion
619 if ( m_logNew
&& m_logNew
!= this )
623 void wxLogChain::DoLog(wxLogLevel level
, const wxChar
*szString
, time_t t
)
625 // let the previous logger show it
626 if ( m_logOld
&& IsPassingMessages() )
628 // bogus cast just to access protected DoLog
629 ((wxLogChain
*)m_logOld
)->DoLog(level
, szString
, t
);
632 if ( m_logNew
&& m_logNew
!= this )
635 ((wxLogChain
*)m_logNew
)->DoLog(level
, szString
, t
);
639 // ----------------------------------------------------------------------------
641 // ----------------------------------------------------------------------------
644 // "'this' : used in base member initializer list" - so what?
645 #pragma warning(disable:4355)
648 wxLogPassThrough::wxLogPassThrough()
654 #pragma warning(default:4355)
657 // ============================================================================
658 // Global functions/variables
659 // ============================================================================
661 // ----------------------------------------------------------------------------
663 // ----------------------------------------------------------------------------
665 wxLog
*wxLog::ms_pLogger
= (wxLog
*)NULL
;
666 bool wxLog::ms_doLog
= true;
667 bool wxLog::ms_bAutoCreate
= true;
668 bool wxLog::ms_bVerbose
= false;
670 wxLogLevel
wxLog::ms_logLevel
= wxLOG_Max
; // log everything by default
672 size_t wxLog::ms_suspendCount
= 0;
674 const wxChar
*wxLog::ms_timestamp
= wxT("%X"); // time only, no date
676 wxTraceMask
wxLog::ms_ulTraceMask
= (wxTraceMask
)0;
677 wxArrayString
wxLog::ms_aTraceMasks
;
679 // ----------------------------------------------------------------------------
680 // stdout error logging helper
681 // ----------------------------------------------------------------------------
683 // helper function: wraps the message and justifies it under given position
684 // (looks more pretty on the terminal). Also adds newline at the end.
686 // TODO this is now disabled until I find a portable way of determining the
687 // terminal window size (ok, I found it but does anybody really cares?)
688 #ifdef LOG_PRETTY_WRAP
689 static void wxLogWrap(FILE *f
, const char *pszPrefix
, const char *psz
)
691 size_t nMax
= 80; // FIXME
692 size_t nStart
= strlen(pszPrefix
);
696 while ( *psz
!= '\0' ) {
697 for ( n
= nStart
; (n
< nMax
) && (*psz
!= '\0'); n
++ )
701 if ( *psz
!= '\0' ) {
703 for ( n
= 0; n
< nStart
; n
++ )
706 // as we wrapped, squeeze all white space
707 while ( isspace(*psz
) )
714 #endif //LOG_PRETTY_WRAP
716 // ----------------------------------------------------------------------------
717 // error code/error message retrieval functions
718 // ----------------------------------------------------------------------------
720 // get error code from syste
721 unsigned long wxSysErrorCode()
723 #if defined(__WXMSW__) && !defined(__WXMICROWIN__)
724 return ::GetLastError();
730 // get error message from system
731 const wxChar
*wxSysErrorMsg(unsigned long nErrCode
)
734 nErrCode
= wxSysErrorCode();
736 #if defined(__WXMSW__) && !defined(__WXMICROWIN__)
737 static wxChar s_szBuf
[LOG_BUFFER_SIZE
/ 2];
739 // get error message from system
741 FormatMessage(FORMAT_MESSAGE_ALLOCATE_BUFFER
| FORMAT_MESSAGE_FROM_SYSTEM
,
743 MAKELANGID(LANG_NEUTRAL
, SUBLANG_DEFAULT
),
747 // copy it to our buffer and free memory
748 // Crashes on SmartPhone
749 #if !defined(__SMARTPHONE__) /* of WinCE */
750 if( lpMsgBuf
!= 0 ) {
751 wxStrncpy(s_szBuf
, (const wxChar
*)lpMsgBuf
, WXSIZEOF(s_szBuf
) - 1);
752 s_szBuf
[WXSIZEOF(s_szBuf
) - 1] = wxT('\0');
756 // returned string is capitalized and ended with '\r\n' - bad
757 s_szBuf
[0] = (wxChar
)wxTolower(s_szBuf
[0]);
758 size_t len
= wxStrlen(s_szBuf
);
761 if ( s_szBuf
[len
- 2] == wxT('\r') )
762 s_szBuf
[len
- 2] = wxT('\0');
768 s_szBuf
[0] = wxT('\0');
772 #else // Unix-WXMICROWIN
774 static wxChar s_szBuf
[LOG_BUFFER_SIZE
/ 2];
775 wxConvCurrent
->MB2WC(s_szBuf
, strerror(nErrCode
), WXSIZEOF(s_szBuf
) -1);
778 return strerror((int)nErrCode
);
780 #endif // Win/Unix-WXMICROWIN