]> git.saurik.com Git - wxWidgets.git/blame - src/common/log.cpp
Fix a number of mingw compile errors.
[wxWidgets.git] / src / common / log.cpp
CommitLineData
c801d85f 1/////////////////////////////////////////////////////////////////////////////
e4db172a 2// Name: src/common/log.cpp
c801d85f
KB
3// Purpose: Assorted wxLogXXX functions, and wxLog (sink for logs)
4// Author: Vadim Zeitlin
5// Modified by:
6// Created: 29/01/98
7// RCS-ID: $Id$
8// Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
65571936 9// Licence: wxWindows licence
c801d85f
KB
10/////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
dd85fc6b 19
c801d85f
KB
20// For compilers that support precompilation, includes "wx.h".
21#include "wx/wxprec.h"
22
23#ifdef __BORLANDC__
e2478fde 24 #pragma hdrstop
c801d85f
KB
25#endif
26
e2478fde
VZ
27#if wxUSE_LOG
28
77ffb593 29// wxWidgets
c801d85f 30#ifndef WX_PRECOMP
e4db172a 31 #include "wx/log.h"
e90c1d2a 32 #include "wx/app.h"
df5168c4 33 #include "wx/arrstr.h"
e2478fde
VZ
34 #include "wx/intl.h"
35 #include "wx/string.h"
de6185e2 36 #include "wx/utils.h"
9ef3052c 37#endif //WX_PRECOMP
c801d85f 38
e2478fde 39#include "wx/apptrait.h"
7b2d1c74 40#include "wx/datetime.h"
e2478fde 41#include "wx/file.h"
e2478fde
VZ
42#include "wx/msgout.h"
43#include "wx/textfile.h"
44#include "wx/thread.h"
acad886c 45#include "wx/private/threadinfo.h"
3a3dde0d 46#include "wx/crt.h"
232addd1 47#include "wx/vector.h"
f94dfb38 48
c801d85f 49// other standard headers
1c193821 50#ifndef __WXWINCE__
e2478fde 51#include <errno.h>
1c193821
JS
52#endif
53
e2478fde 54#include <stdlib.h>
1c193821 55
9b4da627 56#ifndef __WXPALMOS5__
1c193821 57#ifndef __WXWINCE__
e2478fde 58#include <time.h>
1c193821
JS
59#else
60#include "wx/msw/wince/time.h"
61#endif
9b4da627 62#endif /* ! __WXPALMOS5__ */
31907d03 63
9cce3be7
VS
64#if defined(__WINDOWS__)
65 #include "wx/msw/private.h" // includes windows.h
66#endif
67
c602c59b
VZ
68#undef wxLOG_COMPONENT
69const char *wxLOG_COMPONENT = "";
70
d5e7d2ec
VZ
71// this macro allows to define an object which will be initialized before any
72// other function in this file is called: this is necessary to allow log
73// functions to be used during static initialization (this is not advisable
74// anyhow but we should at least try to not crash) and to also ensure that they
75// are initialized by the time static initialization is done, i.e. before any
76// threads are created hopefully
77//
bc1e0d4d
VZ
78// the net effect of all this is that you can use Get##name() function to
79// access the object without worrying about it being not initialized
d5e7d2ec
VZ
80//
81// see also WX_DEFINE_GLOBAL_CONV2() in src/common/strconv.cpp
bc1e0d4d
VZ
82#define WX_DEFINE_GLOBAL_VAR(type, name) \
83 inline type& Get##name() \
d5e7d2ec 84 { \
bc1e0d4d
VZ
85 static type s_##name; \
86 return s_##name; \
d5e7d2ec
VZ
87 } \
88 \
bc1e0d4d
VZ
89 type *gs_##name##Ptr = &Get##name()
90
9d7cb671
VZ
91#if wxUSE_THREADS
92
93wxTLS_TYPE(wxThreadSpecificInfo) wxThreadInfoVar;
94
bc1e0d4d
VZ
95namespace
96{
97
98// contains messages logged by the other threads and waiting to be shown until
99// Flush() is called in the main one
100typedef wxVector<wxLogRecord> wxLogRecords;
101wxLogRecords gs_bufferedLogRecords;
102
103#define WX_DEFINE_LOG_CS(name) WX_DEFINE_GLOBAL_VAR(wxCriticalSection, name##CS)
766aecab 104
232addd1
VZ
105// this critical section is used for buffering the messages from threads other
106// than main, i.e. it protects all accesses to gs_bufferedLogRecords above
d5e7d2ec 107WX_DEFINE_LOG_CS(BackgroundLog);
232addd1 108
55e5154d 109// this one is used for protecting TraceMasks() from concurrent access
d5e7d2ec 110WX_DEFINE_LOG_CS(TraceMask);
c602c59b 111
03647350 112// and this one is used for GetComponentLevels()
d5e7d2ec 113WX_DEFINE_LOG_CS(Levels);
c602c59b 114
232addd1
VZ
115} // anonymous namespace
116
766aecab
VZ
117#endif // wxUSE_THREADS
118
c801d85f
KB
119// ----------------------------------------------------------------------------
120// non member functions
121// ----------------------------------------------------------------------------
122
123// define this to enable wrapping of log messages
124//#define LOG_PRETTY_WRAP
125
9ef3052c 126#ifdef LOG_PRETTY_WRAP
c801d85f
KB
127 static void wxLogWrap(FILE *f, const char *pszPrefix, const char *psz);
128#endif
129
bc73d5ae
VZ
130// ----------------------------------------------------------------------------
131// module globals
132// ----------------------------------------------------------------------------
133
134namespace
135{
136
137// this struct is used to store information about the previous log message used
138// by OnLog() to (optionally) avoid logging multiple copies of the same message
139struct PreviousLogInfo
140{
141 PreviousLogInfo()
142 {
143 numRepeated = 0;
144 }
145
146
147 // previous message itself
148 wxString msg;
149
150 // its level
151 wxLogLevel level;
152
153 // other information about it
154 wxLogRecordInfo info;
155
156 // the number of times it was already repeated
157 unsigned numRepeated;
158};
159
160PreviousLogInfo gs_prevLog;
161
c602c59b
VZ
162
163// map containing all components for which log level was explicitly set
164//
165// NB: all accesses to it must be protected by GetLevelsCS() critical section
bc1e0d4d 166WX_DEFINE_GLOBAL_VAR(wxStringToNumHashMap, ComponentLevels);
c602c59b 167
55b24eb8
VZ
168// ----------------------------------------------------------------------------
169// wxLogOutputBest: wxLog wrapper around wxMessageOutputBest
170// ----------------------------------------------------------------------------
171
172class wxLogOutputBest : public wxLog
173{
174public:
175 wxLogOutputBest() { }
176
177protected:
178 virtual void DoLogText(const wxString& msg)
179 {
180 wxMessageOutputBest().Output(msg);
181 }
182
183private:
184 wxDECLARE_NO_COPY_CLASS(wxLogOutputBest);
185};
186
bc73d5ae
VZ
187} // anonymous namespace
188
c801d85f
KB
189// ============================================================================
190// implementation
191// ============================================================================
192
b568d04f 193// ----------------------------------------------------------------------------
af588446 194// helper global functions
b568d04f
VZ
195// ----------------------------------------------------------------------------
196
c11d62a6
VZ
197void wxSafeShowMessage(const wxString& title, const wxString& text)
198{
199#ifdef __WINDOWS__
dc874fb4 200 ::MessageBox(NULL, text.t_str(), title.t_str(), MB_OK | MB_ICONSTOP);
c11d62a6 201#else
a0516656 202 wxFprintf(stderr, wxS("%s: %s\n"), title.c_str(), text.c_str());
65f06384 203 fflush(stderr);
c11d62a6
VZ
204#endif
205}
206
c801d85f
KB
207// ----------------------------------------------------------------------------
208// wxLog class implementation
209// ----------------------------------------------------------------------------
210
dbaa16de 211unsigned wxLog::LogLastRepeatIfNeeded()
dbaa16de 212{
bc73d5ae 213 const unsigned count = gs_prevLog.numRepeated;
0250efd6 214
bc73d5ae 215 if ( gs_prevLog.numRepeated )
f9837791
VZ
216 {
217 wxString msg;
459b97df 218#if wxUSE_INTL
f9837791
VZ
219 msg.Printf(wxPLURAL("The previous message repeated once.",
220 "The previous message repeated %lu times.",
bc73d5ae
VZ
221 gs_prevLog.numRepeated),
222 gs_prevLog.numRepeated);
459b97df 223#else
a0516656 224 msg.Printf(wxS("The previous message was repeated %lu times."),
bc73d5ae 225 gs_prevLog.numRepeated);
459b97df 226#endif
bc73d5ae
VZ
227 gs_prevLog.numRepeated = 0;
228 gs_prevLog.msg.clear();
229 DoLogRecord(gs_prevLog.level, msg, gs_prevLog.info);
f9837791 230 }
0250efd6
VZ
231
232 return count;
f9837791
VZ
233}
234
235wxLog::~wxLog()
236{
6f6b48f1
VZ
237 // Flush() must be called before destroying the object as otherwise some
238 // messages could be lost
bc73d5ae 239 if ( gs_prevLog.numRepeated )
6f6b48f1
VZ
240 {
241 wxMessageOutputDebug().Printf
242 (
243 wxS("Last repeated message (\"%s\", %lu times) wasn't output"),
bc73d5ae
VZ
244 gs_prevLog.msg,
245 gs_prevLog.numRepeated
6f6b48f1
VZ
246 );
247 }
f9837791
VZ
248}
249
bc73d5ae
VZ
250// ----------------------------------------------------------------------------
251// wxLog logging functions
252// ----------------------------------------------------------------------------
253
254/* static */
255void
256wxLog::OnLog(wxLogLevel level, const wxString& msg, time_t t)
257{
258 wxLogRecordInfo info;
259 info.timestamp = t;
260#if wxUSE_THREADS
261 info.threadId = wxThread::GetCurrentId();
262#endif // wxUSE_THREADS
263
264 OnLog(level, msg, info);
265}
266
f9837791 267/* static */
bc73d5ae
VZ
268void
269wxLog::OnLog(wxLogLevel level,
270 const wxString& msg,
271 const wxLogRecordInfo& info)
f9837791 272{
af588446
VZ
273 // fatal errors can't be suppressed nor handled by the custom log target
274 // and always terminate the program
275 if ( level == wxLOG_FatalError )
f9837791 276 {
af588446 277 wxSafeShowMessage(wxS("Fatal Error"), msg);
a2d38265 278
af588446
VZ
279#ifdef __WXWINCE__
280 ExitThread(3);
281#else
282 abort();
283#endif
284 }
2064113c 285
acad886c 286 wxLog *logger;
2064113c 287
232addd1
VZ
288#if wxUSE_THREADS
289 if ( !wxThread::IsMain() )
290 {
acad886c
VZ
291 logger = wxThreadInfo.logger;
292 if ( !logger )
293 {
294 if ( ms_pLogger )
295 {
296 // buffer the messages until they can be shown from the main
297 // thread
298 wxCriticalSectionLocker lock(GetBackgroundLogCS());
232addd1 299
acad886c 300 gs_bufferedLogRecords.push_back(wxLogRecord(level, msg, info));
232addd1 301
acad886c
VZ
302 // ensure that our Flush() will be called soon
303 wxWakeUpIdle();
304 }
305 //else: we don't have any logger at all, there is no need to log
306 // anything
232addd1 307
acad886c
VZ
308 return;
309 }
310 //else: we have a thread-specific logger, we can send messages to it
311 // directly
232addd1 312 }
acad886c 313 else
232addd1 314#endif // wxUSE_THREADS
acad886c 315 {
5d7526b0 316 logger = GetMainThreadActiveTarget();
acad886c
VZ
317 if ( !logger )
318 return;
319 }
232addd1 320
acad886c 321 logger->CallDoLogNow(level, msg, info);
232addd1
VZ
322}
323
324void
acad886c
VZ
325wxLog::CallDoLogNow(wxLogLevel level,
326 const wxString& msg,
327 const wxLogRecordInfo& info)
232addd1 328{
af588446
VZ
329 if ( GetRepetitionCounting() )
330 {
af588446
VZ
331 if ( msg == gs_prevLog.msg )
332 {
333 gs_prevLog.numRepeated++;
2064113c 334
af588446
VZ
335 // nothing else to do, in particular, don't log the
336 // repeated message
337 return;
f9837791 338 }
af588446 339
16b1f6fc 340 LogLastRepeatIfNeeded();
af588446
VZ
341
342 // reset repetition counter for a new message
343 gs_prevLog.msg = msg;
344 gs_prevLog.level = level;
345 gs_prevLog.info = info;
f9837791 346 }
af588446
VZ
347
348 // handle extra data which may be passed to us by wxLogXXX()
349 wxString prefix, suffix;
0758c46e 350 wxUIntPtr num = 0;
af588446
VZ
351 if ( info.GetNumValue(wxLOG_KEY_SYS_ERROR_CODE, &num) )
352 {
b804f992 353 const long err = static_cast<long>(num);
af588446
VZ
354
355 suffix.Printf(_(" (error %ld: %s)"), err, wxSysErrorMsg(err));
356 }
357
358#if wxUSE_LOG_TRACE
359 wxString str;
360 if ( level == wxLOG_Trace && info.GetStrValue(wxLOG_KEY_TRACE_MASK, &str) )
361 {
362 prefix = "(" + str + ") ";
363 }
364#endif // wxUSE_LOG_TRACE
365
232addd1 366 DoLogRecord(level, prefix + msg + suffix, info);
f9837791
VZ
367}
368
bc73d5ae
VZ
369void wxLog::DoLogRecord(wxLogLevel level,
370 const wxString& msg,
371 const wxLogRecordInfo& info)
04662def 372{
bc73d5ae
VZ
373#if WXWIN_COMPATIBILITY_2_8
374 // call the old DoLog() to ensure that existing custom log classes still
375 // work
376 //
377 // as the user code could have defined it as either taking "const char *"
378 // (in ANSI build) or "const wxChar *" (in ANSI/Unicode), we have no choice
379 // but to call both of them
380 DoLog(level, (const char*)msg.mb_str(), info.timestamp);
381 DoLog(level, (const wchar_t*)msg.wc_str(), info.timestamp);
36a6cfd2
VZ
382#else // !WXWIN_COMPATIBILITY_2_8
383 wxUnusedVar(info);
384#endif // WXWIN_COMPATIBILITY_2_8/!WXWIN_COMPATIBILITY_2_8
bc73d5ae
VZ
385
386
387 // TODO: it would be better to extract message formatting in a separate
388 // wxLogFormatter class but for now we hard code formatting here
389
390 wxString prefix;
391
392 // don't time stamp debug messages under MSW as debug viewers usually
393 // already have an option to do it
394#ifdef __WXMSW__
395 if ( level != wxLOG_Debug && level != wxLOG_Trace )
396#endif // __WXMSW__
397 TimeStamp(&prefix);
398
399 // TODO: use the other wxLogRecordInfo fields
400
401 switch ( level )
402 {
403 case wxLOG_Error:
404 prefix += _("Error: ");
405 break;
406
407 case wxLOG_Warning:
408 prefix += _("Warning: ");
409 break;
410
411 // don't prepend "debug/trace" prefix under MSW as it goes to the debug
412 // window anyhow and so can't be confused with something else
413#ifndef __WXMSW__
414 case wxLOG_Debug:
415 // this prefix (as well as the one below) is intentionally not
416 // translated as nobody translates debug messages anyhow
417 prefix += "Debug: ";
418 break;
419
420 case wxLOG_Trace:
421 prefix += "Trace: ";
422 break;
423#endif // !__WXMSW__
424 }
425
426 DoLogTextAtLevel(level, prefix + msg);
04662def
RL
427}
428
bc73d5ae
VZ
429void wxLog::DoLogTextAtLevel(wxLogLevel level, const wxString& msg)
430{
431 // we know about debug messages (because using wxMessageOutputDebug is the
432 // right thing to do in 99% of all cases and also for compatibility) but
433 // anything else needs to be handled in the derived class
434 if ( level == wxLOG_Debug || level == wxLOG_Trace )
435 {
436 wxMessageOutputDebug().Output(msg + wxS('\n'));
437 }
438 else
439 {
440 DoLogText(msg);
441 }
442}
dcc40ba5 443
bc73d5ae
VZ
444void wxLog::DoLogText(const wxString& WXUNUSED(msg))
445{
446 // in 2.8-compatible build the derived class might override DoLog() or
447 // DoLogString() instead so we can't have this assert there
448#if !WXWIN_COMPATIBILITY_2_8
449 wxFAIL_MSG( "must be overridden if it is called" );
450#endif // WXWIN_COMPATIBILITY_2_8
451}
5d88a6b5 452
fbbc4e8f
VZ
453#if WXWIN_COMPATIBILITY_2_8
454
bc73d5ae 455void wxLog::DoLog(wxLogLevel WXUNUSED(level), const char *szString, time_t t)
5d88a6b5 456{
bc73d5ae 457 DoLogString(szString, t);
5d88a6b5
VZ
458}
459
bc73d5ae 460void wxLog::DoLog(wxLogLevel WXUNUSED(level), const wchar_t *wzString, time_t t)
5d88a6b5 461{
bc73d5ae 462 DoLogString(wzString, t);
5d88a6b5
VZ
463}
464
fbbc4e8f
VZ
465#endif // WXWIN_COMPATIBILITY_2_8
466
bc73d5ae
VZ
467// ----------------------------------------------------------------------------
468// wxLog active target management
469// ----------------------------------------------------------------------------
5d88a6b5 470
9ec05cc9
VZ
471wxLog *wxLog::GetActiveTarget()
472{
acad886c
VZ
473#if wxUSE_THREADS
474 if ( !wxThread::IsMain() )
475 {
476 // check if we have a thread-specific log target
477 wxLog * const logger = wxThreadInfo.logger;
478
479 // the code below should be only executed for the main thread as
480 // CreateLogTarget() is not meant for auto-creating log targets for
481 // worker threads so skip it in any case
482 return logger ? logger : ms_pLogger;
483 }
484#endif // wxUSE_THREADS
485
5d7526b0
VZ
486 return GetMainThreadActiveTarget();
487}
488
489/* static */
490wxLog *wxLog::GetMainThreadActiveTarget()
491{
0fb67cd1
VZ
492 if ( ms_bAutoCreate && ms_pLogger == NULL ) {
493 // prevent infinite recursion if someone calls wxLogXXX() from
494 // wxApp::CreateLogTarget()
f644b28c 495 static bool s_bInGetActiveTarget = false;
0fb67cd1 496 if ( !s_bInGetActiveTarget ) {
f644b28c 497 s_bInGetActiveTarget = true;
0fb67cd1 498
0fb67cd1
VZ
499 // ask the application to create a log target for us
500 if ( wxTheApp != NULL )
dc6d5e38 501 ms_pLogger = wxTheApp->GetTraits()->CreateLogTarget();
0fb67cd1 502 else
55b24eb8 503 ms_pLogger = new wxLogOutputBest;
0fb67cd1 504
f644b28c 505 s_bInGetActiveTarget = false;
0fb67cd1
VZ
506
507 // do nothing if it fails - what can we do?
508 }
275bf4c1 509 }
c801d85f 510
0fb67cd1 511 return ms_pLogger;
c801d85f
KB
512}
513
c085e333 514wxLog *wxLog::SetActiveTarget(wxLog *pLogger)
9ec05cc9 515{
0fb67cd1
VZ
516 if ( ms_pLogger != NULL ) {
517 // flush the old messages before changing because otherwise they might
518 // get lost later if this target is not restored
519 ms_pLogger->Flush();
520 }
c801d85f 521
0fb67cd1
VZ
522 wxLog *pOldLogger = ms_pLogger;
523 ms_pLogger = pLogger;
c085e333 524
0fb67cd1 525 return pOldLogger;
c801d85f
KB
526}
527
acad886c
VZ
528#if wxUSE_THREADS
529/* static */
530wxLog *wxLog::SetThreadActiveTarget(wxLog *logger)
531{
532 wxASSERT_MSG( !wxThread::IsMain(), "use SetActiveTarget() for main thread" );
533
534 wxLog * const oldLogger = wxThreadInfo.logger;
535 if ( oldLogger )
536 oldLogger->Flush();
537
538 wxThreadInfo.logger = logger;
539
540 return oldLogger;
541}
542#endif // wxUSE_THREADS
543
36bd6902
VZ
544void wxLog::DontCreateOnDemand()
545{
f644b28c 546 ms_bAutoCreate = false;
36bd6902
VZ
547
548 // this is usually called at the end of the program and we assume that it
549 // is *always* called at the end - so we free memory here to avoid false
550 // memory leak reports from wxWin memory tracking code
551 ClearTraceMasks();
552}
553
e94cd97d
DE
554void wxLog::DoCreateOnDemand()
555{
556 ms_bAutoCreate = true;
557}
558
c602c59b
VZ
559// ----------------------------------------------------------------------------
560// wxLog components levels
561// ----------------------------------------------------------------------------
562
563/* static */
564void wxLog::SetComponentLevel(const wxString& component, wxLogLevel level)
565{
566 if ( component.empty() )
567 {
568 SetLogLevel(level);
569 }
570 else
571 {
572 wxCRIT_SECT_LOCKER(lock, GetLevelsCS());
573
bc1e0d4d 574 GetComponentLevels()[component] = level;
c602c59b
VZ
575 }
576}
577
578/* static */
579wxLogLevel wxLog::GetComponentLevel(wxString component)
580{
581 wxCRIT_SECT_LOCKER(lock, GetLevelsCS());
582
bc1e0d4d 583 const wxStringToNumHashMap& componentLevels = GetComponentLevels();
c602c59b
VZ
584 while ( !component.empty() )
585 {
586 wxStringToNumHashMap::const_iterator
bc1e0d4d
VZ
587 it = componentLevels.find(component);
588 if ( it != componentLevels.end() )
c602c59b
VZ
589 return static_cast<wxLogLevel>(it->second);
590
591 component = component.BeforeLast('/');
592 }
593
594 return GetLogLevel();
595}
596
597// ----------------------------------------------------------------------------
598// wxLog trace masks
599// ----------------------------------------------------------------------------
600
55e5154d
VZ
601namespace
602{
603
604// because IsAllowedTraceMask() may be called during static initialization
605// (this is not recommended but it may still happen, see #11592) we can't use a
606// simple static variable which might be not initialized itself just yet to
607// store the trace masks, but need this accessor function which will ensure
608// that the variable is always correctly initialized before being accessed
609//
610// notice that this doesn't make accessing it MT-safe, of course, you need to
611// serialize accesses to it using GetTraceMaskCS() for this
612wxArrayString& TraceMasks()
613{
614 static wxArrayString s_traceMasks;
615
616 return s_traceMasks;
617}
618
619} // anonymous namespace
620
621/* static */ const wxArrayString& wxLog::GetTraceMasks()
622{
623 // because of this function signature (it returns a reference, not the
624 // object), it is inherently MT-unsafe so there is no need to acquire the
625 // lock here anyhow
626
627 return TraceMasks();
628}
629
f96233d5
VZ
630void wxLog::AddTraceMask(const wxString& str)
631{
766aecab 632 wxCRIT_SECT_LOCKER(lock, GetTraceMaskCS());
f96233d5 633
55e5154d 634 TraceMasks().push_back(str);
f96233d5
VZ
635}
636
0fb67cd1 637void wxLog::RemoveTraceMask(const wxString& str)
c801d85f 638{
766aecab 639 wxCRIT_SECT_LOCKER(lock, GetTraceMaskCS());
f96233d5 640
55e5154d 641 int index = TraceMasks().Index(str);
0fb67cd1 642 if ( index != wxNOT_FOUND )
55e5154d 643 TraceMasks().RemoveAt((size_t)index);
0fb67cd1 644}
c801d85f 645
36bd6902
VZ
646void wxLog::ClearTraceMasks()
647{
766aecab 648 wxCRIT_SECT_LOCKER(lock, GetTraceMaskCS());
f96233d5 649
55e5154d 650 TraceMasks().Clear();
36bd6902
VZ
651}
652
c602c59b
VZ
653/*static*/ bool wxLog::IsAllowedTraceMask(const wxString& mask)
654{
655 wxCRIT_SECT_LOCKER(lock, GetTraceMaskCS());
656
55e5154d
VZ
657 const wxArrayString& masks = GetTraceMasks();
658 for ( wxArrayString::const_iterator it = masks.begin(),
659 en = masks.end();
660 it != en;
661 ++it )
c602c59b
VZ
662 {
663 if ( *it == mask)
664 return true;
665 }
666
667 return false;
668}
669
670// ----------------------------------------------------------------------------
671// wxLog miscellaneous other methods
672// ----------------------------------------------------------------------------
673
d2e1ef19
VZ
674void wxLog::TimeStamp(wxString *str)
675{
7b2d1c74 676#if wxUSE_DATETIME
cb296f30 677 if ( !ms_timestamp.empty() )
d2e1ef19 678 {
01904487
VZ
679 *str = wxDateTime::UNow().Format(ms_timestamp);
680 *str += wxS(": ");
d2e1ef19 681 }
7b2d1c74 682#endif // wxUSE_DATETIME
d2e1ef19
VZ
683}
684
232addd1 685#if wxUSE_THREADS
232addd1 686
acad886c
VZ
687void wxLog::FlushThreadMessages()
688{
232addd1
VZ
689 // check if we have queued messages from other threads
690 wxLogRecords bufferedLogRecords;
691
692 {
693 wxCriticalSectionLocker lock(GetBackgroundLogCS());
694 bufferedLogRecords.swap(gs_bufferedLogRecords);
695
696 // release the lock now to not keep it while we are logging the
697 // messages below, allowing background threads to run
698 }
699
700 if ( !bufferedLogRecords.empty() )
701 {
702 for ( wxLogRecords::const_iterator it = bufferedLogRecords.begin();
703 it != bufferedLogRecords.end();
704 ++it )
705 {
acad886c 706 CallDoLogNow(it->level, it->msg, it->info);
232addd1
VZ
707 }
708 }
acad886c
VZ
709}
710
53ff8df7
VZ
711/* static */
712bool wxLog::IsThreadLoggingEnabled()
713{
714 return !wxThreadInfo.loggingDisabled;
715}
716
717/* static */
718bool wxLog::EnableThreadLogging(bool enable)
719{
720 const bool wasEnabled = !wxThreadInfo.loggingDisabled;
721 wxThreadInfo.loggingDisabled = !enable;
722 return wasEnabled;
723}
724
232addd1
VZ
725#endif // wxUSE_THREADS
726
acad886c
VZ
727void wxLog::Flush()
728{
6f6b48f1 729 LogLastRepeatIfNeeded();
c801d85f
KB
730}
731
acad886c
VZ
732/* static */
733void wxLog::FlushActive()
734{
735 if ( ms_suspendCount )
736 return;
737
738 wxLog * const log = GetActiveTarget();
739 if ( log )
740 {
741#if wxUSE_THREADS
742 if ( wxThread::IsMain() )
743 log->FlushThreadMessages();
744#endif // wxUSE_THREADS
745
746 log->Flush();
747 }
748}
749
d3fc1755
VZ
750// ----------------------------------------------------------------------------
751// wxLogBuffer implementation
752// ----------------------------------------------------------------------------
753
754void wxLogBuffer::Flush()
755{
232addd1
VZ
756 wxLog::Flush();
757
a23bbe93
VZ
758 if ( !m_str.empty() )
759 {
760 wxMessageOutputBest out;
a0516656 761 out.Printf(wxS("%s"), m_str.c_str());
a23bbe93
VZ
762 m_str.clear();
763 }
d3fc1755
VZ
764}
765
bc73d5ae 766void wxLogBuffer::DoLogTextAtLevel(wxLogLevel level, const wxString& msg)
83250f1a 767{
711f12ef
VZ
768 // don't put debug messages in the buffer, we don't want to show
769 // them to the user in a msg box, log them immediately
bc73d5ae 770 switch ( level )
711f12ef 771 {
bc73d5ae
VZ
772 case wxLOG_Debug:
773 case wxLOG_Trace:
774 wxLog::DoLogTextAtLevel(level, msg);
775 break;
83250f1a 776
bc73d5ae
VZ
777 default:
778 m_str << msg << wxS("\n");
83250f1a
VZ
779 }
780}
781
c801d85f
KB
782// ----------------------------------------------------------------------------
783// wxLogStderr class implementation
784// ----------------------------------------------------------------------------
785
786wxLogStderr::wxLogStderr(FILE *fp)
787{
0fb67cd1
VZ
788 if ( fp == NULL )
789 m_fp = stderr;
790 else
791 m_fp = fp;
c801d85f
KB
792}
793
bc73d5ae 794void wxLogStderr::DoLogText(const wxString& msg)
c801d85f 795{
bc73d5ae 796 wxFputs(msg + '\n', m_fp);
0fb67cd1 797 fflush(m_fp);
1e8a4bc2 798
e2478fde
VZ
799 // under GUI systems such as Windows or Mac, programs usually don't have
800 // stderr at all, so show the messages also somewhere else, typically in
801 // the debugger window so that they go at least somewhere instead of being
802 // simply lost
1ec5cbf3
VZ
803 if ( m_fp == stderr )
804 {
e2478fde
VZ
805 wxAppTraits *traits = wxTheApp ? wxTheApp->GetTraits() : NULL;
806 if ( traits && !traits->HasStderr() )
807 {
bc73d5ae 808 wxMessageOutputDebug().Output(msg + wxS('\n'));
e2478fde 809 }
03147cd0 810 }
c801d85f
KB
811}
812
813// ----------------------------------------------------------------------------
814// wxLogStream implementation
815// ----------------------------------------------------------------------------
816
4bf78aae 817#if wxUSE_STD_IOSTREAM
65f19af1 818#include "wx/ioswrap.h"
dd107c50 819wxLogStream::wxLogStream(wxSTD ostream *ostr)
c801d85f 820{
0fb67cd1 821 if ( ostr == NULL )
dd107c50 822 m_ostr = &wxSTD cerr;
0fb67cd1
VZ
823 else
824 m_ostr = ostr;
c801d85f
KB
825}
826
bc73d5ae 827void wxLogStream::DoLogText(const wxString& msg)
c801d85f 828{
bc73d5ae 829 (*m_ostr) << msg << wxSTD endl;
c801d85f 830}
0fb67cd1 831#endif // wxUSE_STD_IOSTREAM
c801d85f 832
03147cd0
VZ
833// ----------------------------------------------------------------------------
834// wxLogChain
835// ----------------------------------------------------------------------------
836
837wxLogChain::wxLogChain(wxLog *logger)
838{
f644b28c 839 m_bPassMessages = true;
71debe95 840
03147cd0
VZ
841 m_logNew = logger;
842 m_logOld = wxLog::SetActiveTarget(this);
843}
844
199e91fb
VZ
845wxLogChain::~wxLogChain()
846{
a16e51b5 847 wxLog::SetActiveTarget(m_logOld);
e95f8fde
VZ
848
849 if ( m_logNew != this )
850 delete m_logNew;
199e91fb
VZ
851}
852
03147cd0
VZ
853void wxLogChain::SetLog(wxLog *logger)
854{
855 if ( m_logNew != this )
856 delete m_logNew;
857
03147cd0
VZ
858 m_logNew = logger;
859}
860
861void wxLogChain::Flush()
862{
863 if ( m_logOld )
864 m_logOld->Flush();
865
1ec5cbf3 866 // be careful to avoid infinite recursion
03147cd0
VZ
867 if ( m_logNew && m_logNew != this )
868 m_logNew->Flush();
869}
870
bc73d5ae
VZ
871void wxLogChain::DoLogRecord(wxLogLevel level,
872 const wxString& msg,
873 const wxLogRecordInfo& info)
03147cd0
VZ
874{
875 // let the previous logger show it
876 if ( m_logOld && IsPassingMessages() )
bc73d5ae 877 m_logOld->LogRecord(level, msg, info);
03147cd0 878
efce878a 879 // and also send it to the new one
51eb0606
VZ
880 if ( m_logNew )
881 {
882 // don't call m_logNew->LogRecord() to avoid infinite recursion when
883 // m_logNew is this object itself
884 if ( m_logNew != this )
885 m_logNew->LogRecord(level, msg, info);
886 else
887 wxLog::DoLogRecord(level, msg, info);
888 }
03147cd0
VZ
889}
890
93d4c1d0
VZ
891#ifdef __VISUALC__
892 // "'this' : used in base member initializer list" - so what?
893 #pragma warning(disable:4355)
894#endif // VC++
895
47fe7ff3
JS
896// ----------------------------------------------------------------------------
897// wxLogInterposer
898// ----------------------------------------------------------------------------
899
900wxLogInterposer::wxLogInterposer()
901 : wxLogChain(this)
902{
903}
904
905// ----------------------------------------------------------------------------
906// wxLogInterposerTemp
907// ----------------------------------------------------------------------------
908
909wxLogInterposerTemp::wxLogInterposerTemp()
93d4c1d0
VZ
910 : wxLogChain(this)
911{
766aecab 912 DetachOldLog();
93d4c1d0
VZ
913}
914
915#ifdef __VISUALC__
916 #pragma warning(default:4355)
917#endif // VC++
918
c801d85f
KB
919// ============================================================================
920// Global functions/variables
921// ============================================================================
922
923// ----------------------------------------------------------------------------
924// static variables
925// ----------------------------------------------------------------------------
0fb67cd1 926
f9837791 927bool wxLog::ms_bRepetCounting = false;
f9837791 928
d3b9f782 929wxLog *wxLog::ms_pLogger = NULL;
f644b28c
WS
930bool wxLog::ms_doLog = true;
931bool wxLog::ms_bAutoCreate = true;
932bool wxLog::ms_bVerbose = false;
d2e1ef19 933
edc73852
RD
934wxLogLevel wxLog::ms_logLevel = wxLOG_Max; // log everything by default
935
2ed3265e
VZ
936size_t wxLog::ms_suspendCount = 0;
937
a0516656 938wxString wxLog::ms_timestamp(wxS("%X")); // time only, no date
d2e1ef19 939
34085a0d 940#if WXWIN_COMPATIBILITY_2_8
0fb67cd1 941wxTraceMask wxLog::ms_ulTraceMask = (wxTraceMask)0;
34085a0d
VZ
942#endif // wxDEBUG_LEVEL
943
c801d85f
KB
944// ----------------------------------------------------------------------------
945// stdout error logging helper
946// ----------------------------------------------------------------------------
947
948// helper function: wraps the message and justifies it under given position
949// (looks more pretty on the terminal). Also adds newline at the end.
950//
0fb67cd1
VZ
951// TODO this is now disabled until I find a portable way of determining the
952// terminal window size (ok, I found it but does anybody really cares?)
953#ifdef LOG_PRETTY_WRAP
c801d85f
KB
954static void wxLogWrap(FILE *f, const char *pszPrefix, const char *psz)
955{
0fb67cd1
VZ
956 size_t nMax = 80; // FIXME
957 size_t nStart = strlen(pszPrefix);
958 fputs(pszPrefix, f);
959
960 size_t n;
961 while ( *psz != '\0' ) {
962 for ( n = nStart; (n < nMax) && (*psz != '\0'); n++ )
963 putc(*psz++, f);
964
965 // wrapped?
966 if ( *psz != '\0' ) {
967 /*putc('\n', f);*/
968 for ( n = 0; n < nStart; n++ )
969 putc(' ', f);
970
971 // as we wrapped, squeeze all white space
972 while ( isspace(*psz) )
973 psz++;
974 }
c801d85f 975 }
c801d85f 976
0fb67cd1 977 putc('\n', f);
c801d85f
KB
978}
979#endif //LOG_PRETTY_WRAP
980
981// ----------------------------------------------------------------------------
982// error code/error message retrieval functions
983// ----------------------------------------------------------------------------
984
985// get error code from syste
986unsigned long wxSysErrorCode()
987{
8cb172b4 988#if defined(__WXMSW__) && !defined(__WXMICROWIN__)
0fb67cd1 989 return ::GetLastError();
0fb67cd1 990#else //Unix
c801d85f 991 return errno;
0fb67cd1 992#endif //Win/Unix
c801d85f
KB
993}
994
995// get error message from system
50920146 996const wxChar *wxSysErrorMsg(unsigned long nErrCode)
c801d85f 997{
0fb67cd1
VZ
998 if ( nErrCode == 0 )
999 nErrCode = wxSysErrorCode();
1000
8cb172b4 1001#if defined(__WXMSW__) && !defined(__WXMICROWIN__)
2e7f3845 1002 static wxChar s_szBuf[1024];
0fb67cd1
VZ
1003
1004 // get error message from system
1005 LPVOID lpMsgBuf;
d0822e56
VZ
1006 if ( ::FormatMessage
1007 (
1008 FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,
1009 NULL,
1010 nErrCode,
0fb67cd1
VZ
1011 MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
1012 (LPTSTR)&lpMsgBuf,
d0822e56
VZ
1013 0,
1014 NULL
1015 ) == 0 )
1016 {
1017 // if this happens, something is seriously wrong, so don't use _() here
1018 // for safety
a0516656 1019 wxSprintf(s_szBuf, wxS("unknown error %lx"), nErrCode);
c4b401b6 1020 return s_szBuf;
d0822e56
VZ
1021 }
1022
0fb67cd1
VZ
1023
1024 // copy it to our buffer and free memory
d0822e56 1025 // Crashes on SmartPhone (FIXME)
0c44ec97 1026#if !defined(__SMARTPHONE__) /* of WinCE */
7448de8d
WS
1027 if( lpMsgBuf != 0 )
1028 {
e408bf52 1029 wxStrlcpy(s_szBuf, (const wxChar *)lpMsgBuf, WXSIZEOF(s_szBuf));
251244a0
VZ
1030
1031 LocalFree(lpMsgBuf);
1032
1033 // returned string is capitalized and ended with '\r\n' - bad
1034 s_szBuf[0] = (wxChar)wxTolower(s_szBuf[0]);
1035 size_t len = wxStrlen(s_szBuf);
1036 if ( len > 0 ) {
1037 // truncate string
a0516656
VZ
1038 if ( s_szBuf[len - 2] == wxS('\r') )
1039 s_szBuf[len - 2] = wxS('\0');
251244a0
VZ
1040 }
1041 }
a9928e9d 1042 else
2e7f3845 1043#endif // !__SMARTPHONE__
a9928e9d 1044 {
a0516656 1045 s_szBuf[0] = wxS('\0');
0fb67cd1
VZ
1046 }
1047
1048 return s_szBuf;
2e7f3845
VZ
1049#else // !__WXMSW__
1050 #if wxUSE_UNICODE
1051 static wchar_t s_wzBuf[1024];
1052 wxConvCurrent->MB2WC(s_wzBuf, strerror((int)nErrCode),
1053 WXSIZEOF(s_wzBuf) - 1);
1054 return s_wzBuf;
1055 #else
1056 return strerror((int)nErrCode);
1057 #endif
1058#endif // __WXMSW__/!__WXMSW__
c801d85f
KB
1059}
1060
e2478fde 1061#endif // wxUSE_LOG