src/common/log.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        log.cpp
   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>
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // ============================================================================
  13 // declarations
  14 // ============================================================================
  15
  16 // ----------------------------------------------------------------------------
  17 // headers
  18 // ----------------------------------------------------------------------------
  19
  20 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
  21     #pragma implementation "log.h"
  22 #endif
  23
  24 // For compilers that support precompilation, includes "wx.h".
  25 #include "wx/wxprec.h"
  26
  27 #ifdef __BORLANDC__
  28     #pragma hdrstop
  29 #endif
  30
  31 #if wxUSE_LOG
  32
  33 // wxWidgets
  34 #ifndef WX_PRECOMP
  35     #include "wx/app.h"
  36     #include "wx/arrstr.h"
  37     #include "wx/intl.h"
  38     #include "wx/string.h"
  39 #endif //WX_PRECOMP
  40
  41 #include "wx/apptrait.h"
  42 #include "wx/file.h"
  43 #include "wx/log.h"
  44 #include "wx/msgout.h"
  45 #include "wx/textfile.h"
  46 #include "wx/thread.h"
  47 #include "wx/utils.h"
  48 #include "wx/wxchar.h"
  49
  50 // other standard headers
  51 #ifndef __WXWINCE__
  52 #include <errno.h>
  53 #endif
  54
  55 #include <stdlib.h>
  56
  57 #ifndef __WXWINCE__
  58 #include <time.h>
  59 #else
  60 #include "wx/msw/wince/time.h"
  61 #endif
  62
  63 #if defined(__WINDOWS__)
  64     #include "wx/msw/private.h" // includes windows.h
  65 #endif
  66
  67 // ----------------------------------------------------------------------------
  68 // non member functions
  69 // ----------------------------------------------------------------------------
  70
  71 // define this to enable wrapping of log messages
  72 //#define LOG_PRETTY_WRAP
  73
  74 #ifdef  LOG_PRETTY_WRAP
  75   static void wxLogWrap(FILE *f, const char *pszPrefix, const char *psz);
  76 #endif
  77
  78 // ============================================================================
  79 // implementation
  80 // ============================================================================
  81
  82 // ----------------------------------------------------------------------------
  83 // globals
  84 // ----------------------------------------------------------------------------
  85
  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)
  89
  90 // static buffer for error messages
  91 static wxChar   s_szBufStatic[LOG_BUFFER_SIZE];
  92
  93 static wxChar  *s_szBuf     = s_szBufStatic;
  94 static size_t   s_szBufSize = WXSIZEOF( s_szBufStatic );
  95
  96 #if wxUSE_THREADS
  97
  98 // the critical section protecting the static buffer
  99 static wxCriticalSection gs_csLogBuf;
 100
 101 #endif // wxUSE_THREADS
 102
 103 // return true if we have a non NULL non disabled log target
 104 static inline bool IsLoggingEnabled()
 105 {
 106     return wxLog::IsEnabled() && (wxLog::GetActiveTarget() != NULL);
 107 }
 108
 109 // ----------------------------------------------------------------------------
 110 // implementation of Log functions
 111 //
 112 // NB: unfortunately we need all these distinct functions, we can't make them
 113 //     macros and not all compilers inline vararg functions.
 114 // ----------------------------------------------------------------------------
 115
 116 // wrapper for wxVsnprintf(s_szBuf) which always NULL-terminates it
 117 static inline void PrintfInLogBug(const wxChar *szFormat, va_list argptr)
 118 {
 119     if ( wxVsnprintf(s_szBuf, s_szBufSize, szFormat, argptr) < 0 )
 120     {
 121         // must NUL-terminate it manually
 122         s_szBuf[s_szBufSize - 1] = _T('\0');
 123     }
 124     //else: NUL-terminated by vsnprintf()
 125 }
 126
 127 // generic log function
 128 void wxVLogGeneric(wxLogLevel level, const wxChar *szFormat, va_list argptr)
 129 {
 130     if ( IsLoggingEnabled() ) {
 131         wxCRIT_SECT_LOCKER(locker, gs_csLogBuf);
 132
 133         PrintfInLogBug(szFormat, argptr);
 134
 135         wxLog::OnLog(level, s_szBuf, time(NULL));
 136     }
 137 }
 138
 139 void wxLogGeneric(wxLogLevel level, const wxChar *szFormat, ...)
 140 {
 141     va_list argptr;
 142     va_start(argptr, szFormat);
 143     wxVLogGeneric(level, szFormat, argptr);
 144     va_end(argptr);
 145 }
 146
 147 #define IMPLEMENT_LOG_FUNCTION(level)                               \
 148   void wxVLog##level(const wxChar *szFormat, va_list argptr)        \
 149   {                                                                 \
 150     if ( IsLoggingEnabled() ) {                                     \
 151       wxCRIT_SECT_LOCKER(locker, gs_csLogBuf);                      \
 152                                                                     \
 153       PrintfInLogBug(szFormat, argptr);                             \
 154                                                                     \
 155       wxLog::OnLog(wxLOG_##level, s_szBuf, time(NULL));             \
 156     }                                                               \
 157   }                                                                 \
 158                                                                     \
 159   void wxLog##level(const wxChar *szFormat, ...)                    \
 160   {                                                                 \
 161     va_list argptr;                                                 \
 162     va_start(argptr, szFormat);                                     \
 163     wxVLog##level(szFormat, argptr);                                \
 164     va_end(argptr);                                                 \
 165   }
 166
 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)
 172
 173 void wxSafeShowMessage(const wxString& title, const wxString& text)
 174 {
 175 #ifdef __WINDOWS__
 176     ::MessageBox(NULL, text, title, MB_OK | MB_ICONSTOP);
 177 #else
 178     wxFprintf(stderr, _T("%s: %s\n"), title.c_str(), text.c_str());
 179 #endif
 180 }
 181
 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)
 185 {
 186     wxVsnprintf(s_szBuf, s_szBufSize, szFormat, argptr);
 187
 188     wxSafeShowMessage(_T("Fatal Error"), s_szBuf);
 189
 190 #ifdef __WXWINCE__
 191     ExitThread(3);
 192 #else
 193     abort();
 194 #endif
 195 }
 196
 197 void wxLogFatalError(const wxChar *szFormat, ...)
 198 {
 199     va_list argptr;
 200     va_start(argptr, szFormat);
 201     wxVLogFatalError(szFormat, argptr);
 202
 203     // some compilers warn about unreachable code and it shouldn't matter
 204     // for the others anyhow...
 205     //va_end(argptr);
 206 }
 207
 208 // same as info, but only if 'verbose' mode is on
 209 void wxVLogVerbose(const wxChar *szFormat, va_list argptr)
 210 {
 211     if ( IsLoggingEnabled() ) {
 212         if ( wxLog::GetActiveTarget() != NULL && wxLog::GetVerbose() ) {
 213             wxCRIT_SECT_LOCKER(locker, gs_csLogBuf);
 214
 215             wxVsnprintf(s_szBuf, s_szBufSize, szFormat, argptr);
 216
 217             wxLog::OnLog(wxLOG_Info, s_szBuf, time(NULL));
 218         }
 219     }
 220 }
 221
 222 void wxLogVerbose(const wxChar *szFormat, ...)
 223 {
 224     va_list argptr;
 225     va_start(argptr, szFormat);
 226     wxVLogVerbose(szFormat, argptr);
 227     va_end(argptr);
 228 }
 229
 230 // debug functions
 231 #ifdef __WXDEBUG__
 232 #define IMPLEMENT_LOG_DEBUG_FUNCTION(level)                         \
 233   void wxVLog##level(const wxChar *szFormat, va_list argptr)        \
 234   {                                                                 \
 235     if ( IsLoggingEnabled() ) {                                     \
 236       wxCRIT_SECT_LOCKER(locker, gs_csLogBuf);                      \
 237                                                                     \
 238       wxVsnprintf(s_szBuf, s_szBufSize, szFormat, argptr);    \
 239                                                                     \
 240       wxLog::OnLog(wxLOG_##level, s_szBuf, time(NULL));             \
 241     }                                                               \
 242   }                                                                 \
 243   void wxLog##level(const wxChar *szFormat, ...)                    \
 244   {                                                                 \
 245     va_list argptr;                                                 \
 246     va_start(argptr, szFormat);                                     \
 247     wxVLog##level(szFormat, argptr);                                \
 248     va_end(argptr);                                                 \
 249   }
 250
 251   void wxVLogTrace(const wxChar *mask, const wxChar *szFormat, va_list argptr)
 252   {
 253     if ( IsLoggingEnabled() && wxLog::IsAllowedTraceMask(mask) ) {
 254       wxCRIT_SECT_LOCKER(locker, gs_csLogBuf);
 255
 256       wxChar *p = s_szBuf;
 257       size_t len = s_szBufSize;
 258       wxStrncpy(s_szBuf, _T("("), len);
 259       len -= 1; // strlen("(")
 260       p += 1;
 261       wxStrncat(p, mask, len);
 262       size_t lenMask = wxStrlen(mask);
 263       len -= lenMask;
 264       p += lenMask;
 265
 266       wxStrncat(p, _T(") "), len);
 267       len -= 2;
 268       p += 2;
 269
 270       wxVsnprintf(p, len, szFormat, argptr);
 271
 272       wxLog::OnLog(wxLOG_Trace, s_szBuf, time(NULL));
 273     }
 274   }
 275
 276   void wxLogTrace(const wxChar *mask, const wxChar *szFormat, ...)
 277   {
 278     va_list argptr;
 279     va_start(argptr, szFormat);
 280     wxVLogTrace(mask, szFormat, argptr);
 281     va_end(argptr);
 282   }
 283
 284   void wxVLogTrace(wxTraceMask mask, const wxChar *szFormat, va_list argptr)
 285   {
 286     // we check that all of mask bits are set in the current mask, so
 287     // that wxLogTrace(wxTraceRefCount | wxTraceOle) will only do something
 288     // if both bits are set.
 289     if ( IsLoggingEnabled() && ((wxLog::GetTraceMask() & mask) == mask) ) {
 290       wxCRIT_SECT_LOCKER(locker, gs_csLogBuf);
 291
 292       wxVsnprintf(s_szBuf, s_szBufSize, szFormat, argptr);
 293
 294       wxLog::OnLog(wxLOG_Trace, s_szBuf, time(NULL));
 295     }
 296   }
 297
 298   void wxLogTrace(wxTraceMask mask, const wxChar *szFormat, ...)
 299   {
 300     va_list argptr;
 301     va_start(argptr, szFormat);
 302     wxVLogTrace(mask, szFormat, argptr);
 303     va_end(argptr);
 304   }
 305
 306 #else // release
 307   #define IMPLEMENT_LOG_DEBUG_FUNCTION(level)
 308 #endif
 309
 310 IMPLEMENT_LOG_DEBUG_FUNCTION(Debug)
 311 IMPLEMENT_LOG_DEBUG_FUNCTION(Trace)
 312
 313 // wxLogSysError: one uses the last error code, for other  you must give it
 314 // explicitly
 315
 316 // common part of both wxLogSysError
 317 void wxLogSysErrorHelper(long lErrCode)
 318 {
 319     wxChar szErrMsg[LOG_BUFFER_SIZE / 2];
 320     wxSnprintf(szErrMsg, WXSIZEOF(szErrMsg),
 321                _(" (error %ld: %s)"), lErrCode, wxSysErrorMsg(lErrCode));
 322     wxStrncat(s_szBuf, szErrMsg, s_szBufSize - wxStrlen(s_szBuf));
 323
 324     wxLog::OnLog(wxLOG_Error, s_szBuf, time(NULL));
 325 }
 326
 327 void WXDLLEXPORT wxVLogSysError(const wxChar *szFormat, va_list argptr)
 328 {
 329     if ( IsLoggingEnabled() ) {
 330         wxCRIT_SECT_LOCKER(locker, gs_csLogBuf);
 331
 332         wxVsnprintf(s_szBuf, s_szBufSize, szFormat, argptr);
 333
 334         wxLogSysErrorHelper(wxSysErrorCode());
 335     }
 336 }
 337
 338 void WXDLLEXPORT wxLogSysError(const wxChar *szFormat, ...)
 339 {
 340     va_list argptr;
 341     va_start(argptr, szFormat);
 342     wxVLogSysError(szFormat, argptr);
 343     va_end(argptr);
 344 }
 345
 346 void WXDLLEXPORT wxVLogSysError(long lErrCode, const wxChar *szFormat, va_list argptr)
 347 {
 348     if ( IsLoggingEnabled() ) {
 349         wxCRIT_SECT_LOCKER(locker, gs_csLogBuf);
 350
 351         wxVsnprintf(s_szBuf, s_szBufSize, szFormat, argptr);
 352
 353         wxLogSysErrorHelper(lErrCode);
 354     }
 355 }
 356
 357 void WXDLLEXPORT wxLogSysError(long lErrCode, const wxChar *szFormat, ...)
 358 {
 359     va_list argptr;
 360     va_start(argptr, szFormat);
 361     wxVLogSysError(lErrCode, szFormat, argptr);
 362     va_end(argptr);
 363 }
 364
 365 // ----------------------------------------------------------------------------
 366 // wxLog class implementation
 367 // ----------------------------------------------------------------------------
 368
 369 wxChar *wxLog::SetLogBuffer( wxChar *buf, size_t size)
 370 {
 371     wxChar *oldbuf = s_szBuf;
 372
 373     if( buf == 0 )
 374     {
 375         s_szBuf = s_szBufStatic;
 376         s_szBufSize = WXSIZEOF( s_szBufStatic );
 377     }
 378     else
 379     {
 380         s_szBuf = buf;
 381         s_szBufSize = size;
 382     }
 383
 384     return (oldbuf == s_szBufStatic ) ? 0 : oldbuf;
 385 }
 386
 387 wxLog *wxLog::GetActiveTarget()
 388 {
 389     if ( ms_bAutoCreate && ms_pLogger == NULL ) {
 390         // prevent infinite recursion if someone calls wxLogXXX() from
 391         // wxApp::CreateLogTarget()
 392         static bool s_bInGetActiveTarget = false;
 393         if ( !s_bInGetActiveTarget ) {
 394             s_bInGetActiveTarget = true;
 395
 396             // ask the application to create a log target for us
 397             if ( wxTheApp != NULL )
 398                 ms_pLogger = wxTheApp->GetTraits()->CreateLogTarget();
 399             else
 400                 ms_pLogger = new wxLogStderr;
 401
 402             s_bInGetActiveTarget = false;
 403
 404             // do nothing if it fails - what can we do?
 405         }
 406     }
 407
 408     return ms_pLogger;
 409 }
 410
 411 wxLog *wxLog::SetActiveTarget(wxLog *pLogger)
 412 {
 413     if ( ms_pLogger != NULL ) {
 414         // flush the old messages before changing because otherwise they might
 415         // get lost later if this target is not restored
 416         ms_pLogger->Flush();
 417     }
 418
 419     wxLog *pOldLogger = ms_pLogger;
 420     ms_pLogger = pLogger;
 421
 422     return pOldLogger;
 423 }
 424
 425 void wxLog::DontCreateOnDemand()
 426 {
 427     ms_bAutoCreate = false;
 428
 429     // this is usually called at the end of the program and we assume that it
 430     // is *always* called at the end - so we free memory here to avoid false
 431     // memory leak reports from wxWin  memory tracking code
 432     ClearTraceMasks();
 433 }
 434
 435 void wxLog::RemoveTraceMask(const wxString& str)
 436 {
 437     int index = ms_aTraceMasks.Index(str);
 438     if ( index != wxNOT_FOUND )
 439         ms_aTraceMasks.RemoveAt((size_t)index);
 440 }
 441
 442 void wxLog::ClearTraceMasks()
 443 {
 444     ms_aTraceMasks.Clear();
 445 }
 446
 447 void wxLog::TimeStamp(wxString *str)
 448 {
 449     if ( ms_timestamp )
 450     {
 451         wxChar buf[256];
 452         time_t timeNow;
 453         (void)time(&timeNow);
 454         wxStrftime(buf, WXSIZEOF(buf), ms_timestamp, localtime(&timeNow));
 455
 456         str->Empty();
 457         *str << buf << wxT(": ");
 458     }
 459 }
 460
 461 void wxLog::DoLog(wxLogLevel level, const wxChar *szString, time_t t)
 462 {
 463     switch ( level ) {
 464         case wxLOG_FatalError:
 465             DoLogString(wxString(_("Fatal error: ")) + szString, t);
 466             DoLogString(_("Program aborted."), t);
 467             Flush();
 468 #ifdef __WXWINCE__
 469             ExitThread(3);
 470 #else
 471             abort();
 472 #endif
 473             break;
 474
 475         case wxLOG_Error:
 476             DoLogString(wxString(_("Error: ")) + szString, t);
 477             break;
 478
 479         case wxLOG_Warning:
 480             DoLogString(wxString(_("Warning: ")) + szString, t);
 481             break;
 482
 483         case wxLOG_Info:
 484             if ( GetVerbose() )
 485         case wxLOG_Message:
 486         case wxLOG_Status:
 487         default:    // log unknown log levels too
 488                 DoLogString(szString, t);
 489             break;
 490
 491         case wxLOG_Trace:
 492         case wxLOG_Debug:
 493 #ifdef __WXDEBUG__
 494             {
 495                 wxString msg = level == wxLOG_Trace ? wxT("Trace: ")
 496                                                     : wxT("Debug: ");
 497                 msg << szString;
 498                 DoLogString(msg, t);
 499             }
 500 #endif // Debug
 501             break;
 502     }
 503 }
 504
 505 void wxLog::DoLogString(const wxChar *WXUNUSED(szString), time_t WXUNUSED(t))
 506 {
 507     wxFAIL_MSG(wxT("DoLogString must be overriden if it's called."));
 508 }
 509
 510 void wxLog::Flush()
 511 {
 512     // nothing to do here
 513 }
 514
 515 /*static*/ bool wxLog::IsAllowedTraceMask(const wxChar *mask)
 516 {
 517     for ( wxArrayString::iterator it = ms_aTraceMasks.begin(),
 518                                   en = ms_aTraceMasks.end();
 519          it != en; ++it )
 520         if ( *it == mask)
 521             return true;
 522     return false;
 523 }
 524
 525 // ----------------------------------------------------------------------------
 526 // wxLogBuffer implementation
 527 // ----------------------------------------------------------------------------
 528
 529 void wxLogBuffer::Flush()
 530 {
 531     if ( !m_str.empty() )
 532     {
 533         wxMessageOutputBest out;
 534         out.Printf(_T("%s"), m_str.c_str());
 535         m_str.clear();
 536     }
 537 }
 538
 539 void wxLogBuffer::DoLog(wxLogLevel level, const wxChar *szString, time_t t)
 540 {
 541     switch ( level )
 542     {
 543         case wxLOG_Trace:
 544         case wxLOG_Debug:
 545 #ifdef __WXDEBUG__
 546             // don't put debug messages in the buffer, we don't want to show
 547             // them to the user in a msg box, log them immediately
 548             {
 549                 wxString str;
 550                 TimeStamp(&str);
 551                 str += szString;
 552
 553                 wxMessageOutputDebug().Printf(_T("%s\n"), str.c_str());
 554             }
 555 #endif // __WXDEBUG__
 556             break;
 557
 558         default:
 559             wxLog::DoLog(level, szString, t);
 560     }
 561 }
 562
 563 void wxLogBuffer::DoLogString(const wxChar *szString, time_t WXUNUSED(t))
 564 {
 565     m_str << szString << _T("\n");
 566 }
 567
 568 // ----------------------------------------------------------------------------
 569 // wxLogStderr class implementation
 570 // ----------------------------------------------------------------------------
 571
 572 wxLogStderr::wxLogStderr(FILE *fp)
 573 {
 574     if ( fp == NULL )
 575         m_fp = stderr;
 576     else
 577         m_fp = fp;
 578 }
 579
 580 void wxLogStderr::DoLogString(const wxChar *szString, time_t WXUNUSED(t))
 581 {
 582     wxString str;
 583     TimeStamp(&str);
 584     str << szString;
 585
 586     fputs(str.mb_str(), m_fp);
 587     fputc(_T('\n'), m_fp);
 588     fflush(m_fp);
 589
 590     // under GUI systems such as Windows or Mac, programs usually don't have
 591     // stderr at all, so show the messages also somewhere else, typically in
 592     // the debugger window so that they go at least somewhere instead of being
 593     // simply lost
 594     if ( m_fp == stderr )
 595     {
 596         wxAppTraits *traits = wxTheApp ? wxTheApp->GetTraits() : NULL;
 597         if ( traits && !traits->HasStderr() )
 598         {
 599             wxMessageOutputDebug dbgout;
 600             dbgout.Printf(_T("%s\n"), str.c_str());
 601         }
 602     }
 603 }
 604
 605 // ----------------------------------------------------------------------------
 606 // wxLogStream implementation
 607 // ----------------------------------------------------------------------------
 608
 609 #if wxUSE_STD_IOSTREAM
 610 #include "wx/ioswrap.h"
 611 wxLogStream::wxLogStream(wxSTD ostream *ostr)
 612 {
 613     if ( ostr == NULL )
 614         m_ostr = &wxSTD cerr;
 615     else
 616         m_ostr = ostr;
 617 }
 618
 619 void wxLogStream::DoLogString(const wxChar *szString, time_t WXUNUSED(t))
 620 {
 621     wxString str;
 622     TimeStamp(&str);
 623     (*m_ostr) << str << wxConvertWX2MB(szString) << wxSTD endl;
 624 }
 625 #endif // wxUSE_STD_IOSTREAM
 626
 627 // ----------------------------------------------------------------------------
 628 // wxLogChain
 629 // ----------------------------------------------------------------------------
 630
 631 wxLogChain::wxLogChain(wxLog *logger)
 632 {
 633     m_bPassMessages = true;
 634
 635     m_logNew = logger;
 636     m_logOld = wxLog::SetActiveTarget(this);
 637 }
 638
 639 wxLogChain::~wxLogChain()
 640 {
 641     delete m_logOld;
 642
 643     if ( m_logNew != this )
 644         delete m_logNew;
 645 }
 646
 647 void wxLogChain::SetLog(wxLog *logger)
 648 {
 649     if ( m_logNew != this )
 650         delete m_logNew;
 651
 652     m_logNew = logger;
 653 }
 654
 655 void wxLogChain::Flush()
 656 {
 657     if ( m_logOld )
 658         m_logOld->Flush();
 659
 660     // be careful to avoid infinite recursion
 661     if ( m_logNew && m_logNew != this )
 662         m_logNew->Flush();
 663 }
 664
 665 void wxLogChain::DoLog(wxLogLevel level, const wxChar *szString, time_t t)
 666 {
 667     // let the previous logger show it
 668     if ( m_logOld && IsPassingMessages() )
 669     {
 670         // bogus cast just to access protected DoLog
 671         ((wxLogChain *)m_logOld)->DoLog(level, szString, t);
 672     }
 673
 674     if ( m_logNew && m_logNew != this )
 675     {
 676         // as above...
 677         ((wxLogChain *)m_logNew)->DoLog(level, szString, t);
 678     }
 679 }
 680
 681 // ----------------------------------------------------------------------------
 682 // wxLogPassThrough
 683 // ----------------------------------------------------------------------------
 684
 685 #ifdef __VISUALC__
 686     // "'this' : used in base member initializer list" - so what?
 687     #pragma warning(disable:4355)
 688 #endif // VC++
 689
 690 wxLogPassThrough::wxLogPassThrough()
 691                 : wxLogChain(this)
 692 {
 693 }
 694
 695 #ifdef __VISUALC__
 696     #pragma warning(default:4355)
 697 #endif // VC++
 698
 699 // ============================================================================
 700 // Global functions/variables
 701 // ============================================================================
 702
 703 // ----------------------------------------------------------------------------
 704 // static variables
 705 // ----------------------------------------------------------------------------
 706
 707 wxLog          *wxLog::ms_pLogger      = (wxLog *)NULL;
 708 bool            wxLog::ms_doLog        = true;
 709 bool            wxLog::ms_bAutoCreate  = true;
 710 bool            wxLog::ms_bVerbose     = false;
 711
 712 wxLogLevel      wxLog::ms_logLevel     = wxLOG_Max;  // log everything by default
 713
 714 size_t          wxLog::ms_suspendCount = 0;
 715
 716 const wxChar   *wxLog::ms_timestamp    = wxT("%X");  // time only, no date
 717
 718 wxTraceMask     wxLog::ms_ulTraceMask  = (wxTraceMask)0;
 719 wxArrayString   wxLog::ms_aTraceMasks;
 720
 721 // ----------------------------------------------------------------------------
 722 // stdout error logging helper
 723 // ----------------------------------------------------------------------------
 724
 725 // helper function: wraps the message and justifies it under given position
 726 // (looks more pretty on the terminal). Also adds newline at the end.
 727 //
 728 // TODO this is now disabled until I find a portable way of determining the
 729 //      terminal window size (ok, I found it but does anybody really cares?)
 730 #ifdef LOG_PRETTY_WRAP
 731 static void wxLogWrap(FILE *f, const char *pszPrefix, const char *psz)
 732 {
 733     size_t nMax = 80; // FIXME
 734     size_t nStart = strlen(pszPrefix);
 735     fputs(pszPrefix, f);
 736
 737     size_t n;
 738     while ( *psz != '\0' ) {
 739         for ( n = nStart; (n < nMax) && (*psz != '\0'); n++ )
 740             putc(*psz++, f);
 741
 742         // wrapped?
 743         if ( *psz != '\0' ) {
 744             /*putc('\n', f);*/
 745             for ( n = 0; n < nStart; n++ )
 746                 putc(' ', f);
 747
 748             // as we wrapped, squeeze all white space
 749             while ( isspace(*psz) )
 750                 psz++;
 751         }
 752     }
 753
 754     putc('\n', f);
 755 }
 756 #endif  //LOG_PRETTY_WRAP
 757
 758 // ----------------------------------------------------------------------------
 759 // error code/error message retrieval functions
 760 // ----------------------------------------------------------------------------
 761
 762 // get error code from syste
 763 unsigned long wxSysErrorCode()
 764 {
 765 #if defined(__WXMSW__) && !defined(__WXMICROWIN__)
 766     return ::GetLastError();
 767 #else   //Unix
 768     return errno;
 769 #endif  //Win/Unix
 770 }
 771
 772 // get error message from system
 773 const wxChar *wxSysErrorMsg(unsigned long nErrCode)
 774 {
 775     if ( nErrCode == 0 )
 776         nErrCode = wxSysErrorCode();
 777
 778 #if defined(__WXMSW__) && !defined(__WXMICROWIN__)
 779     static wxChar s_szBuf[LOG_BUFFER_SIZE / 2];
 780
 781     // get error message from system
 782     LPVOID lpMsgBuf;
 783     if ( ::FormatMessage
 784          (
 785             FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,
 786             NULL,
 787             nErrCode,
 788             MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
 789             (LPTSTR)&lpMsgBuf,
 790             0,
 791             NULL
 792          ) == 0 )
 793     {
 794         // if this happens, something is seriously wrong, so don't use _() here
 795         // for safety
 796         wxSprintf(s_szBuf, _T("unknown error %lx"), nErrCode);
 797                 return s_szBuf;
 798     }
 799
 800
 801     // copy it to our buffer and free memory
 802     // Crashes on SmartPhone (FIXME)
 803 #if !defined(__SMARTPHONE__) /* of WinCE */
 804      if( lpMsgBuf != 0 ) {
 805         wxStrncpy(s_szBuf, (const wxChar *)lpMsgBuf, WXSIZEOF(s_szBuf) - 1);
 806         s_szBuf[WXSIZEOF(s_szBuf) - 1] = wxT('\0');
 807
 808         LocalFree(lpMsgBuf);
 809
 810         // returned string is capitalized and ended with '\r\n' - bad
 811         s_szBuf[0] = (wxChar)wxTolower(s_szBuf[0]);
 812         size_t len = wxStrlen(s_szBuf);
 813         if ( len > 0 ) {
 814             // truncate string
 815             if ( s_szBuf[len - 2] == wxT('\r') )
 816                 s_szBuf[len - 2] = wxT('\0');
 817         }
 818     }
 819     else
 820 #endif
 821     {
 822         s_szBuf[0] = wxT('\0');
 823     }
 824
 825     return s_szBuf;
 826 #else   // Unix-WXMICROWIN
 827 #if wxUSE_UNICODE
 828     static wxChar s_szBuf[LOG_BUFFER_SIZE / 2];
 829     wxConvCurrent->MB2WC(s_szBuf, strerror(nErrCode), WXSIZEOF(s_szBuf) -1);
 830     return s_szBuf;
 831 #else
 832     return strerror((int)nErrCode);
 833 #endif
 834 #endif  // Win/Unix-WXMICROWIN
 835 }
 836
 837 #endif // wxUSE_LOG
 838