X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/774e843c036412e0a3bd5945af8e080ffdb3a846..b4b92fa660b3d08b8c26f714abafeb776d3b1cca:/include/wx/log.h diff --git a/include/wx/log.h b/include/wx/log.h index 5d492339b8..db595e7664 100644 --- a/include/wx/log.h +++ b/include/wx/log.h @@ -52,10 +52,19 @@ typedef unsigned long wxLogLevel; // ---------------------------------------------------------------------------- // forward declarations // ---------------------------------------------------------------------------- -class wxTextCtrl; -class wxLogFrame; -class wxFrame; -class ostream; +class WXDLLEXPORT wxTextCtrl; +class WXDLLEXPORT wxLogFrame; +class WXDLLEXPORT wxFrame; + +#if wxUSE_IOSTREAMH + // N.B. BC++ doesn't have istream.h, ostream.h +# include +#else +# include +# if defined(__VISUALC__) || defined(__MWERKS__) + using namespace std; +# endif +#endif // ---------------------------------------------------------------------------- // derive from this class to redirect (or suppress, or ...) log messages @@ -67,9 +76,22 @@ public: // ctor wxLog(); + // these functions allow to completely disable all log messages + // is logging disabled now? + static bool IsEnabled() { return ms_doLog; } + // change the flag state, return the previous one + static bool EnableLogging(bool doIt = TRUE) + { bool doLogOld = ms_doLog; ms_doLog = doIt; return doLogOld; } + // sink function static void OnLog(wxLogLevel level, const char *szString) - { if ( ms_pLogger != 0 ) ms_pLogger->DoLog(level, szString); } + { + if ( IsEnabled() ) { + wxLog *pLogger = GetActiveTarget(); + if ( pLogger ) + pLogger->DoLog(level, szString); + } + } // message buffering // flush shows all messages if they're not logged immediately @@ -82,10 +104,11 @@ public: bool HasPendingMessages() const { return m_bHasMessages; } // only one sink is active at each moment - // change log target, pLogger = NULL disables logging. if bNoFlashOld is true, - // the old log target isn't flashed which might lead to loss of messages! - // returns the previous log target - static wxLog *SetActiveTarget(wxLog *pLogger, bool bNoFlashOld = FALSE); + // get current log target, will call wxApp::CreateLogTarget() to create one + // if none exists + static wxLog *GetActiveTarget(); + // change log target, pLogger may be NULL + static wxLog *SetActiveTarget(wxLog *pLogger); // functions controlling the default wxLog behaviour // verbose mode is activated by standard command-line '-verbose' option @@ -134,6 +157,7 @@ private: // static variables // ---------------- static wxLog *ms_pLogger; // currently active log sink + static bool ms_doLog; // FALSE => all logging disabled static bool ms_bAutoCreate; // automatically create new log targets? static wxTraceMask ms_ulTraceMask; // controls wxLogTrace behaviour }; @@ -156,8 +180,8 @@ private: FILE *m_fp; }; +#if wxUSE_STD_IOSTREAM // log everything to an "ostream", cerr by default -class ostream; class WXDLLEXPORT wxLogStream : public wxLog { public: @@ -171,7 +195,11 @@ protected: // @@ using ptr here to avoid including from this file ostream *m_ostr; }; +#endif + +#ifndef wxUSE_NOGUI +#if wxUSE_STD_IOSTREAM // log everything to a text window (GUI only of course) class WXDLLEXPORT wxLogTextCtrl : public wxLogStream { @@ -180,6 +208,7 @@ public: wxLogTextCtrl(wxTextCtrl *pTextCtrl); ~wxLogTextCtrl(); }; +#endif // ---------------------------------------------------------------------------- // GUI log target, the default one for wxWindows programs @@ -253,6 +282,8 @@ private: wxLogFrame *m_pLogFrame; // the log frame }; +#endif // wxUSE_NOGUI + // ---------------------------------------------------------------------------- // /dev/null log target: suppress logging until this object goes out of scope // ---------------------------------------------------------------------------- @@ -273,12 +304,11 @@ void Foo() { class WXDLLEXPORT wxLogNull { public: - // ctor saves old log target, dtor restores it - wxLogNull() { m_pPrevLogger = wxLog::SetActiveTarget((wxLog *)NULL, TRUE); } - ~wxLogNull() { (void)wxLog::SetActiveTarget(m_pPrevLogger); } + wxLogNull() { m_flagOld = wxLog::EnableLogging(FALSE); } + ~wxLogNull() { (void)wxLog::EnableLogging(m_flagOld); } private: - wxLog *m_pPrevLogger; // old log target + bool m_flagOld; // the previous value of the wxLog::ms_doLog }; // ============================================================================ @@ -348,17 +378,14 @@ DECLARE_LOG_FUNCTION2(SysError, long lErrCode); // parts of the program only) WXDLLEXPORT_DATA(extern bool) g_bVerbose; -// fwd decl to avoid including iostream.h here -class ostream; - // ---------------------------------------------------------------------------- // get error code/error message from system in a portable way // ---------------------------------------------------------------------------- // return the last system error code -unsigned long WXDLLEXPORT wxSysErrorCode(); +WXDLLEXPORT unsigned long wxSysErrorCode(); // return the error message for given (or last if 0) error code -const char* WXDLLEXPORT wxSysErrorMsg(unsigned long nErrCode = 0); +WXDLLEXPORT const char* wxSysErrorMsg(unsigned long nErrCode = 0); // ---------------------------------------------------------------------------- // debug only logging functions: use them with API name and error code