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 license
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 #pragma implementation "log.h"
23 // For compilers that support precompilation, includes "wx.h".
24 #include "wx/wxprec.h"
33 #include <wx/string.h>
37 #include <wx/generic/msgdlgg.h>
38 #include <wx/filedlg.h>
39 #include <wx/textctrl.h>
43 #include <wx/textfile.h>
47 // other standard headers
58 // ----------------------------------------------------------------------------
59 // non member functions
60 // ----------------------------------------------------------------------------
62 // define this to enable wrapping of log messages
63 //#define LOG_PRETTY_WRAP
65 #ifdef LOG_PRETTY_WRAP
66 static void wxLogWrap(FILE *f
, const char *pszPrefix
, const char *psz
);
69 // ============================================================================
71 // ============================================================================
73 // ----------------------------------------------------------------------------
74 // implementation of Log functions
76 // NB: unfortunately we need all these distinct functions, we can't make them
77 // macros and not all compilers inline vararg functions.
78 // ----------------------------------------------------------------------------
80 // log functions can't allocate memory (LogError("out of memory...") should
81 // work!), so we use a static buffer for all log messages
82 #define LOG_BUFFER_SIZE (4096)
84 // static buffer for error messages (@@@ MT-unsafe)
85 static char s_szBuf
[LOG_BUFFER_SIZE
];
87 // generic log function
88 void wxLogGeneric(wxLogLevel level
, const char *szFormat
, ...)
90 if ( wxLog::GetActiveTarget() != NULL
) {
92 va_start(argptr
, szFormat
);
93 vsprintf(s_szBuf
, szFormat
, argptr
);
96 wxLog::OnLog(level
, s_szBuf
);
100 #define IMPLEMENT_LOG_FUNCTION(level) \
101 void wxLog##level(const char *szFormat, ...) \
103 if ( wxLog::GetActiveTarget() != NULL ) { \
105 va_start(argptr, szFormat); \
106 vsprintf(s_szBuf, szFormat, argptr); \
109 wxLog::OnLog(wxLOG_##level, s_szBuf); \
113 IMPLEMENT_LOG_FUNCTION(FatalError
)
114 IMPLEMENT_LOG_FUNCTION(Error
)
115 IMPLEMENT_LOG_FUNCTION(Warning
)
116 IMPLEMENT_LOG_FUNCTION(Message
)
117 IMPLEMENT_LOG_FUNCTION(Info
)
118 IMPLEMENT_LOG_FUNCTION(Status
)
120 // same as info, but only if 'verbose' mode is on
121 void wxLogVerbose(const char *szFormat
, ...)
123 wxLog
*pLog
= wxLog::GetActiveTarget();
124 if ( pLog
!= NULL
&& pLog
->GetVerbose() ) {
126 va_start(argptr
, szFormat
);
127 vsprintf(s_szBuf
, szFormat
, argptr
);
130 wxLog::OnLog(wxLOG_Info
, s_szBuf
);
136 #define IMPLEMENT_LOG_DEBUG_FUNCTION(level) \
137 void wxLog##level(const char *szFormat, ...) \
139 if ( wxLog::GetActiveTarget() != NULL ) { \
141 va_start(argptr, szFormat); \
142 vsprintf(s_szBuf, szFormat, argptr); \
145 wxLog::OnLog(wxLOG_##level, s_szBuf); \
149 void wxLogTrace(wxTraceMask mask
, const char *szFormat
, ...)
151 wxLog
*pLog
= wxLog::GetActiveTarget();
153 // we check that all of mask bits are set in the current mask, so
154 // that wxLogTrace(wxTraceRefCount | wxTraceOle) will only do something
155 // if both bits are set.
156 if ( pLog
!= NULL
&& (pLog
->GetTraceMask() & mask
== mask
) ) {
158 va_start(argptr
, szFormat
);
159 vsprintf(s_szBuf
, szFormat
, argptr
);
162 wxLog::OnLog(wxLOG_Trace
, s_szBuf
);
167 #define IMPLEMENT_LOG_DEBUG_FUNCTION(level)
170 IMPLEMENT_LOG_DEBUG_FUNCTION(Debug
)
171 IMPLEMENT_LOG_DEBUG_FUNCTION(Trace
)
173 // wxLogSysError: one uses the last error code, for other you must give it
176 // common part of both wxLogSysError
177 void wxLogSysErrorHelper(long lErrCode
)
179 char szErrMsg
[LOG_BUFFER_SIZE
/ 2];
180 sprintf(szErrMsg
, _(" (error %ld: %s)"), lErrCode
, wxSysErrorMsg(lErrCode
));
181 strncat(s_szBuf
, szErrMsg
, WXSIZEOF(s_szBuf
) - strlen(s_szBuf
));
183 wxLog::OnLog(wxLOG_Error
, s_szBuf
);
186 void WXDLLEXPORT
wxLogSysError(const char *szFormat
, ...)
189 va_start(argptr
, szFormat
);
190 vsprintf(s_szBuf
, szFormat
, argptr
);
193 wxLogSysErrorHelper(wxSysErrorCode());
196 void WXDLLEXPORT
wxLogSysError(long lErrCode
, const char *szFormat
, ...)
199 va_start(argptr
, szFormat
);
200 vsprintf(s_szBuf
, szFormat
, argptr
);
203 wxLogSysErrorHelper(lErrCode
);
206 // ----------------------------------------------------------------------------
207 // wxLog class implementation
208 // ----------------------------------------------------------------------------
212 m_bHasMessages
= FALSE
;
214 m_szTimeFormat
= "[%d/%b/%y %H:%M:%S] ";
217 wxLog
*wxLog::GetActiveTarget()
219 if ( ms_bAutoCreate
&& ms_pLogger
== NULL
) {
220 // prevent infinite recursion if someone calls wxLogXXX() from
221 // wxApp::CreateLogTarget()
222 static bool s_bInGetActiveTarget
= FALSE
;
223 if ( !s_bInGetActiveTarget
) {
224 s_bInGetActiveTarget
= TRUE
;
226 #ifdef WX_TEST_MINIMAL
227 ms_pLogger
= new wxLogStderr
;
229 // ask the application to create a log target for us
230 ms_pLogger
= wxTheApp
->CreateLogTarget();
233 // do nothing if it fails - what can we do?
240 wxLog
*wxLog::SetActiveTarget(wxLog
*pLogger
)
242 // flush the old messages before changing
243 if ( ms_pLogger
!= NULL
)
246 wxLog
*pOldLogger
= ms_pLogger
;
247 ms_pLogger
= pLogger
;
251 void wxLog::DoLog(wxLogLevel level
, const char *szString
)
255 // prepend a timestamp if not disabled
256 if ( !IsEmpty(m_szTimeFormat
) ) {
262 ptmNow
= localtime(&timeNow
);
264 strftime(szBuf
, WXSIZEOF(szBuf
), m_szTimeFormat
, ptmNow
);
269 case wxLOG_FatalError
:
270 DoLogString(str
<< _("Fatal error: ") << szString
);
271 DoLogString(_("Program aborted."));
277 DoLogString(str
<< _("Error: ") << szString
);
281 DoLogString(str
<< _("Warning: ") << szString
);
287 DoLogString(str
+ szString
);
298 // in addition to normal logging, also send the string to debugger
299 // (don't prepend "Debug" here: it will go to debug window anyhow)
300 ::OutputDebugString(str
+ szString
+ "\n\r");
302 DoLogString(str
<< (level
== wxLOG_Trace
? _("Trace") : _("Debug"))
303 << ": " << szString
);
309 wxFAIL_MSG("unknown log level in wxLog::DoLog");
313 void wxLog::DoLogString(const char *WXUNUSED(szString
))
315 wxFAIL_MSG("DoLogString must be overrided if it's called.");
323 // ----------------------------------------------------------------------------
324 // wxLogStderr class implementation
325 // ----------------------------------------------------------------------------
327 wxLogStderr::wxLogStderr(FILE *fp
)
335 void wxLogStderr::DoLogString(const char *szString
)
337 fputs(szString
, m_fp
);
342 // ----------------------------------------------------------------------------
343 // wxLogStream implementation
344 // ----------------------------------------------------------------------------
346 wxLogStream::wxLogStream(ostream
*ostr
)
354 void wxLogStream::DoLogString(const char *szString
)
356 (*m_ostr
) << szString
<< endl
<< flush
;
359 // ----------------------------------------------------------------------------
360 // wxLogTextCtrl implementation
361 // ----------------------------------------------------------------------------
362 wxLogTextCtrl::wxLogTextCtrl(wxTextCtrl
*pTextCtrl
)
363 // @@@ TODO: in wxGTK wxTextCtrl doesn't derive from streambuf
365 : wxLogStream(new ostream(pTextCtrl
))
370 wxLogTextCtrl::~wxLogTextCtrl()
377 // ----------------------------------------------------------------------------
378 // wxLogGui implementation
379 // ----------------------------------------------------------------------------
381 #ifndef WX_TEST_MINIMAL
388 void wxLogGui::Flush()
390 if ( !m_bHasMessages
)
395 // concatenate all strings (but not too many to not overfill the msg box)
398 nMsgCount
= m_aMessages
.Count();
400 // start from the most recent message
401 for ( uint n
= nMsgCount
; n
> 0; n
-- ) {
402 // for Windows strings longer than this value are wrapped (NT 4.0)
403 const uint nMsgLineWidth
= 156;
405 nLines
+= (m_aMessages
[n
- 1].Len() + nMsgLineWidth
- 1) / nMsgLineWidth
;
407 if ( nLines
> 25 ) // don't put too many lines in message box
410 str
<< m_aMessages
[n
- 1] << "\n";
414 wxMessageBox(str
, _("Error"), wxOK
| wxICON_EXCLAMATION
);
417 wxMessageBox(str
, _("Information"), wxOK
| wxICON_INFORMATION
);
420 // no undisplayed messages whatsoever
426 // the default behaviour is to discard all informational messages if there
427 // are any errors/warnings.
428 void wxLogGui::DoLog(wxLogLevel level
, const char *szString
)
435 m_aMessages
.Add(szString
);
436 m_bHasMessages
= TRUE
;
442 // find the top window and set it's status text if it has any
443 wxWindow
*pWin
= wxTheApp
->GetTopWindow();
444 if ( pWin
!= NULL
&& pWin
->IsKindOf(CLASSINFO(wxFrame
)) ) {
445 wxFrame
*pFrame
= (wxFrame
*)pWin
;
446 pFrame
->SetStatusText(szString
);
455 OutputDebugString(szString
);
456 OutputDebugString("\n\r");
458 // send them to stderr
459 fprintf(stderr
, "%s: %s\n",
460 level
== wxLOG_Trace
? _("Trace") : _("Debug"), szString
);
466 case wxLOG_FatalError
:
467 // show this one immediately
468 wxMessageBox(szString
, _("Fatal error"), wxICON_HAND
);
473 // discard earlier informational messages if this is the 1st error
476 m_bHasMessages
= TRUE
;
480 m_aMessages
.Add(szString
);
484 wxFAIL_MSG("unknown log level in wxLogGui::DoLog");
488 // ----------------------------------------------------------------------------
489 // wxLogWindow implementation
490 // ----------------------------------------------------------------------------
493 class wxLogFrame
: public wxFrame
497 wxLogFrame(const char *szTitle
);
500 void OnClose(wxCommandEvent
& event
);
501 void OnCloseWindow(wxCloseEvent
& event
);
502 void OnSave (wxCommandEvent
& event
);
503 void OnClear(wxCommandEvent
& event
);
506 wxTextCtrl
*TextCtrl() const { return m_pTextCtrl
; }
516 wxTextCtrl
*m_pTextCtrl
;
518 DECLARE_EVENT_TABLE()
521 BEGIN_EVENT_TABLE(wxLogFrame
, wxFrame
)
522 // wxLogWindow menu events
523 EVT_MENU(Menu_Close
, wxLogFrame::OnClose
)
524 EVT_MENU(Menu_Save
, wxLogFrame::OnSave
)
525 EVT_MENU(Menu_Clear
, wxLogFrame::OnClear
)
527 EVT_CLOSE(wxLogFrame::OnCloseWindow
)
530 wxLogFrame::wxLogFrame(const char *szTitle
)
531 : wxFrame(NULL
, -1, szTitle
)
533 // we don't want to be a top-level frame because it would prevent the
534 // application termination when all other frames are closed
535 wxTopLevelWindows
.DeleteObject(this);
537 // @@ kludge: wxSIMPLE_BORDER is simply to prevent wxWindows from creating
538 // a rich edit control instead of a normal one we want
539 m_pTextCtrl
= new wxTextCtrl(this, -1, wxEmptyString
, wxDefaultPosition
,
546 m_pTextCtrl->SetEditable(FALSE);
547 m_pTextCtrl->SetRichEdit(FALSE);
551 wxMenuBar
*pMenuBar
= new wxMenuBar
;
552 wxMenu
*pMenu
= new wxMenu
;
553 pMenu
->Append(Menu_Save
, "&Save...");
554 pMenu
->Append(Menu_Clear
, "C&lear");
555 pMenu
->AppendSeparator();
556 pMenu
->Append(Menu_Close
, "&Close");
557 pMenuBar
->Append(pMenu
, "&Log");
558 SetMenuBar(pMenuBar
);
560 // @@ what about status bar? needed (for menu prompts)?
563 void wxLogFrame::OnClose(wxCommandEvent
& WXUNUSED(event
))
565 // just hide the window
569 void wxLogFrame::OnCloseWindow(wxCloseEvent
& WXUNUSED(event
))
571 // just hide the window
575 void wxLogFrame::OnSave(wxCommandEvent
& WXUNUSED(event
))
579 const char *szFileName
= wxSaveFileSelector("log", "txt", "log.txt");
580 if ( szFileName
== NULL
) {
589 if ( wxFile::Exists(szFileName
) ) {
590 bool bAppend
= FALSE
;
592 strMsg
.Printf(_("Append log to file '%s' "
593 "(choosing [No] will overwrite it)?"), szFileName
);
594 switch ( wxMessageBox(strMsg
, "Question", wxYES_NO
| wxCANCEL
) ) {
607 wxFAIL_MSG("invalid message box return value");
611 bOk
= file
.Open(szFileName
, wxFile::write_append
);
614 bOk
= file
.Create(szFileName
, TRUE
/* overwrite */);
618 bOk
= file
.Create(szFileName
);
621 // retrieve text and save it
622 // -------------------------
624 // @@@@ TODO: no GetNumberOfLines and GetLineText in wxGTK yet
625 wxLogError("Sorry, this function is not implemented under GTK");
627 int nLines
= m_pTextCtrl
->GetNumberOfLines();
628 for ( int nLine
= 0; bOk
&& nLine
< nLines
; nLine
++ ) {
629 bOk
= file
.Write(m_pTextCtrl
->GetLineText(nLine
) + wxTextFile::GetEOL());
637 wxLogError(_("Can't save log contents to file."));
642 void wxLogFrame::OnClear(wxCommandEvent
& WXUNUSED(event
))
644 m_pTextCtrl
->Clear();
647 wxLogWindow::wxLogWindow(const char *szTitle
, bool bShow
)
649 m_pOldLog
= wxLog::GetActiveTarget();
650 m_pLogFrame
= new wxLogFrame(szTitle
);
653 m_pLogFrame
->Show(TRUE
);
656 void wxLogWindow::Show(bool bShow
)
658 m_pLogFrame
->Show(bShow
);
661 void wxLogWindow::DoLog(wxLogLevel level
, const char *szString
)
663 // first let the previous logger show it
664 if ( m_pOldLog
!= NULL
) {
665 // @@@ why can't we access protected wxLog method from here (we derive
666 // from wxLog)? gcc gives "DoLog is protected in this context", what
667 // does this mean? Anyhow, the cast is harmless and let's us do what
669 ((wxLogWindow
*)m_pOldLog
)->DoLog(level
, szString
);
672 // and this will format it nicely and call our DoLogString()
673 wxLog::DoLog(level
, szString
);
676 void wxLogWindow::DoLogString(const char *szString
)
678 // put the text into our window
679 wxTextCtrl
*pText
= m_pLogFrame
->TextCtrl();
681 // remove selection (WriteText is in fact ReplaceSelection)
683 long nLen
= pText
->GetLastPosition();
684 pText
->SetSelection(nLen
, nLen
);
687 pText
->WriteText(szString
);
688 pText
->WriteText("\n"); // "\n" ok here (_not_ "\r\n")
690 // ensure that the line can be seen
694 wxLogWindow::~wxLogWindow()
696 m_pLogFrame
->Close(TRUE
);
699 #endif //WX_TEST_MINIMAL
701 // ============================================================================
702 // Global functions/variables
703 // ============================================================================
705 // ----------------------------------------------------------------------------
707 // ----------------------------------------------------------------------------
708 wxLog
*wxLog::ms_pLogger
= NULL
;
709 bool wxLog::ms_bAutoCreate
= TRUE
;
710 wxTraceMask
wxLog::ms_ulTraceMask
= (wxTraceMask
)0;
712 // ----------------------------------------------------------------------------
713 // stdout error logging helper
714 // ----------------------------------------------------------------------------
716 // helper function: wraps the message and justifies it under given position
717 // (looks more pretty on the terminal). Also adds newline at the end.
719 // @@ this is now disabled until I find a portable way of determining the
720 // terminal window size (ok, I found it but does anybody really cares?)
721 #ifdef LOG_PRETTY_WRAP
722 static void wxLogWrap(FILE *f
, const char *pszPrefix
, const char *psz
)
724 size_t nMax
= 80; // @@@@
725 size_t nStart
= strlen(pszPrefix
);
729 while ( *psz
!= '\0' ) {
730 for ( n
= nStart
; (n
< nMax
) && (*psz
!= '\0'); n
++ )
734 if ( *psz
!= '\0' ) {
736 for ( n
= 0; n
< nStart
; n
++ )
739 // as we wrapped, squeeze all white space
740 while ( isspace(*psz
) )
747 #endif //LOG_PRETTY_WRAP
749 // ----------------------------------------------------------------------------
750 // error code/error message retrieval functions
751 // ----------------------------------------------------------------------------
753 // get error code from syste
754 unsigned long wxSysErrorCode()
758 return ::GetLastError();
760 // @@@@ what to do on Windows 3.1?
768 // get error message from system
769 const char *wxSysErrorMsg(unsigned long nErrCode
)
772 nErrCode
= wxSysErrorCode();
776 static char s_szBuf
[LOG_BUFFER_SIZE
/ 2];
778 // get error message from system
780 FormatMessage(FORMAT_MESSAGE_ALLOCATE_BUFFER
| FORMAT_MESSAGE_FROM_SYSTEM
,
782 MAKELANGID(LANG_NEUTRAL
, SUBLANG_DEFAULT
),
786 // copy it to our buffer and free memory
787 strncpy(s_szBuf
, (const char *)lpMsgBuf
, WXSIZEOF(s_szBuf
) - 1);
788 s_szBuf
[WXSIZEOF(s_szBuf
) - 1] = '\0';
791 // returned string is capitalized and ended with '\r\n' - bad
792 s_szBuf
[0] = (char)wxToLower(s_szBuf
[0]);
793 size_t len
= strlen(s_szBuf
);
796 if ( s_szBuf
[len
- 2] == '\r' )
797 s_szBuf
[len
- 2] = '\0';
806 return strerror(nErrCode
);
810 // ----------------------------------------------------------------------------
812 // ----------------------------------------------------------------------------
825 // this function is called when an assert fails
826 void wxOnAssert(const char *szFile
, int nLine
, const char *szMsg
)
828 // this variable can be set to true to suppress "assert failure" messages
829 static bool s_bNoAsserts
= FALSE
;
830 static bool s_bInAssert
= FALSE
;
833 // He-e-e-e-elp!! we're trapped in endless loop
839 char szBuf
[LOG_BUFFER_SIZE
];
840 sprintf(szBuf
, _("Assert failed in file %s at line %d"), szFile
, nLine
);
841 if ( szMsg
!= NULL
) {
843 strcat(szBuf
, szMsg
);
849 if ( !s_bNoAsserts
) {
850 // send it to the normal log destination
853 strcat(szBuf
, _("\nDo you want to stop the program?"
854 "\nYou can also choose [Cancel] to suppress "
855 "further warnings."));
857 switch ( wxMessageBox(szBuf
, _("Debug"),
858 wxYES_NO
| wxCANCEL
| wxICON_STOP
) ) {
867 //case wxNO: nothing to do