1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: src/common/appbase.cpp
3 // Purpose: implements wxAppConsoleBase class
4 // Author: Vadim Zeitlin
6 // Created: 19.06.2003 (extracted from common/appcmn.cpp)
8 // Copyright: (c) 2003 Vadim Zeitlin <vadim@wxwindows.org>
9 // License: wxWindows license
10 ///////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // for compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
29 #include "wx/msw/wrapwin.h" // includes windows.h for MessageBox()
36 #include "wx/wxcrtvararg.h"
39 #include "wx/apptrait.h"
40 #include "wx/cmdline.h"
41 #include "wx/confbase.h"
42 #include "wx/evtloop.h"
43 #include "wx/filename.h"
44 #include "wx/msgout.h"
45 #include "wx/ptr_scpd.h"
46 #include "wx/tokenzr.h"
48 #if wxUSE_EXCEPTIONS && wxUSE_STL
53 #if !defined(__WXMSW__) || defined(__WXMICROWIN__)
54 #include <signal.h> // for SIGTRAP used by wxTrap()
60 #include "wx/fontmap.h"
61 #endif // wxUSE_FONTMAP
63 #if defined(__DARWIN__) && defined(_MSL_USING_MW_C_HEADERS) && _MSL_USING_MW_C_HEADERS
64 // For MacTypes.h for Debugger function
65 #include <CoreFoundation/CFBase.h>
68 #if defined(__WXMAC__)
70 #include <CoreServices/CoreServices.h>
72 #include "wx/mac/private.h" // includes mac headers
78 #include "wx/stackwalk.h"
80 #include "wx/msw/debughlp.h"
82 #endif // wxUSE_STACKWALKER
85 // wxABI_VERSION can be defined when compiling applications but it should be
86 // left undefined when compiling the library itself, it is then set to its
87 // default value in version.h
88 #if wxABI_VERSION != wxMAJOR_VERSION * 10000 + wxMINOR_VERSION * 100 + 99
89 #error "wxABI_VERSION should not be defined when compiling the library"
92 // ----------------------------------------------------------------------------
93 // private functions prototypes
94 // ----------------------------------------------------------------------------
97 // really just show the assert dialog
98 static bool DoShowAssertDialog(const wxString
& msg
);
100 // prepare for showing the assert dialog, use the given traits or
101 // DoShowAssertDialog() as last fallback to really show it
103 void ShowAssertDialog(const wxString
& szFile
,
105 const wxString
& szFunc
,
106 const wxString
& szCond
,
107 const wxString
& szMsg
,
108 wxAppTraits
*traits
= NULL
);
110 // turn on the trace masks specified in the env variable WXTRACE
111 static void LINKAGEMODE
SetTraceMasks();
112 #endif // __WXDEBUG__
114 // ----------------------------------------------------------------------------
116 // ----------------------------------------------------------------------------
118 wxAppConsole
*wxAppConsoleBase::ms_appInstance
= NULL
;
120 wxAppInitializerFunction
wxAppConsoleBase::ms_appInitFn
= NULL
;
122 // ----------------------------------------------------------------------------
124 // ----------------------------------------------------------------------------
126 // this defines wxEventLoopPtr
127 wxDEFINE_TIED_SCOPED_PTR_TYPE(wxEventLoopBase
)
129 // ============================================================================
130 // wxAppConsoleBase implementation
131 // ============================================================================
133 // ----------------------------------------------------------------------------
135 // ----------------------------------------------------------------------------
137 wxAppConsoleBase::wxAppConsoleBase()
142 ms_appInstance
= wx_static_cast(wxAppConsole
*, this);
147 // In unicode mode the SetTraceMasks call can cause an apptraits to be
148 // created, but since we are still in the constructor the wrong kind will
149 // be created for GUI apps. Destroy it so it can be created again later.
156 wxAppConsoleBase::~wxAppConsoleBase()
161 // ----------------------------------------------------------------------------
162 // initilization/cleanup
163 // ----------------------------------------------------------------------------
165 bool wxAppConsoleBase::Initialize(int& argcOrig
, wxChar
**argvOrig
)
168 GetTraits()->SetLocale();
171 // remember the command line arguments
176 wxPendingEventsLocker
= new wxCriticalSection
;
180 if ( m_appName
.empty() && argv
)
182 // the application name is, by default, the name of its executable file
183 wxFileName::SplitPath(argv
[0], NULL
, &m_appName
, NULL
);
185 #endif // !__WXPALMOS__
190 wxEventLoopBase
*wxAppConsoleBase::CreateMainLoop()
192 return GetTraits()->CreateEventLoop();
195 void wxAppConsoleBase::CleanUp()
203 delete wxPendingEvents
;
204 wxPendingEvents
= NULL
;
207 delete wxPendingEventsLocker
;
208 wxPendingEventsLocker
= NULL
;
209 #endif // wxUSE_THREADS
212 // ----------------------------------------------------------------------------
214 // ----------------------------------------------------------------------------
216 bool wxAppConsoleBase::OnInit()
218 #if wxUSE_CMDLINE_PARSER
219 wxCmdLineParser
parser(argc
, argv
);
221 OnInitCmdLine(parser
);
224 switch ( parser
.Parse(false /* don't show usage */) )
227 cont
= OnCmdLineHelp(parser
);
231 cont
= OnCmdLineParsed(parser
);
235 cont
= OnCmdLineError(parser
);
241 #endif // wxUSE_CMDLINE_PARSER
246 int wxAppConsoleBase::OnRun()
251 int wxAppConsoleBase::OnExit()
254 // delete the config object if any (don't use Get() here, but Set()
255 // because Get() could create a new config object)
256 delete wxConfigBase::Set((wxConfigBase
*) NULL
);
257 #endif // wxUSE_CONFIG
262 void wxAppConsoleBase::Exit()
264 if (m_mainLoop
!= NULL
)
270 // ----------------------------------------------------------------------------
272 // ----------------------------------------------------------------------------
274 wxAppTraits
*wxAppConsoleBase::CreateTraits()
276 return new wxConsoleAppTraits
;
279 wxAppTraits
*wxAppConsoleBase::GetTraits()
281 // FIXME-MT: protect this with a CS?
284 m_traits
= CreateTraits();
286 wxASSERT_MSG( m_traits
, _T("wxApp::CreateTraits() failed?") );
292 // ----------------------------------------------------------------------------
294 // ----------------------------------------------------------------------------
296 int wxAppConsoleBase::MainLoop()
298 wxEventLoopBaseTiedPtr
mainLoop(&m_mainLoop
, CreateMainLoop());
300 return m_mainLoop
? m_mainLoop
->Run() : -1;
303 void wxAppConsoleBase::ExitMainLoop()
305 // we should exit from the main event loop, not just any currently active
306 // (e.g. modal dialog) event loop
307 if ( m_mainLoop
&& m_mainLoop
->IsRunning() )
313 bool wxAppConsoleBase::Pending()
315 // use the currently active message loop here, not m_mainLoop, because if
316 // we're showing a modal dialog (with its own event loop) currently the
317 // main event loop is not running anyhow
318 wxEventLoopBase
* const loop
= wxEventLoopBase::GetActive();
320 return loop
&& loop
->Pending();
323 bool wxAppConsoleBase::Dispatch()
325 // see comment in Pending()
326 wxEventLoopBase
* const loop
= wxEventLoopBase::GetActive();
328 return loop
&& loop
->Dispatch();
331 bool wxAppConsoleBase::HasPendingEvents() const
333 wxENTER_CRIT_SECT( *wxPendingEventsLocker
);
335 bool has
= wxPendingEvents
&& !wxPendingEvents
->IsEmpty();
337 wxLEAVE_CRIT_SECT( *wxPendingEventsLocker
);
343 bool wxAppConsoleBase::IsMainLoopRunning()
345 const wxAppConsole
* const app
= GetInstance();
347 return app
&& app
->m_mainLoop
!= NULL
;
350 void wxAppConsoleBase::ProcessPendingEvents()
353 if ( !wxPendingEventsLocker
)
357 wxENTER_CRIT_SECT( *wxPendingEventsLocker
);
361 // iterate until the list becomes empty
362 wxList::compatibility_iterator node
= wxPendingEvents
->GetFirst();
365 wxEvtHandler
*handler
= (wxEvtHandler
*)node
->GetData();
366 wxPendingEvents
->Erase(node
);
368 // In ProcessPendingEvents(), new handlers might be add
369 // and we can safely leave the critical section here.
370 wxLEAVE_CRIT_SECT( *wxPendingEventsLocker
);
372 handler
->ProcessPendingEvents();
374 wxENTER_CRIT_SECT( *wxPendingEventsLocker
);
376 node
= wxPendingEvents
->GetFirst();
380 wxLEAVE_CRIT_SECT( *wxPendingEventsLocker
);
383 void wxAppConsoleBase::WakeUpIdle()
386 m_mainLoop
->WakeUp();
389 bool wxAppConsoleBase::ProcessIdle()
393 event
.SetEventObject(this);
395 return event
.MoreRequested();
398 int wxAppConsoleBase::FilterEvent(wxEvent
& WXUNUSED(event
))
400 // process the events normally by default
404 // ----------------------------------------------------------------------------
405 // exception handling
406 // ----------------------------------------------------------------------------
411 wxAppConsoleBase::HandleEvent(wxEvtHandler
*handler
,
412 wxEventFunction func
,
413 wxEvent
& event
) const
415 // by default, simply call the handler
416 (handler
->*func
)(event
);
419 void wxAppConsoleBase::OnUnhandledException()
422 // we're called from an exception handler so we can re-throw the exception
423 // to recover its type
430 catch ( std::exception
& e
)
432 what
.Printf("std::exception of type \"%s\", what() = \"%s\"",
433 typeid(e
).name(), e
.what());
438 what
= "unknown exception";
441 wxMessageOutputBest().Printf(
442 "*** Caught unhandled %s; terminating\n", what
444 #endif // __WXDEBUG__
447 // ----------------------------------------------------------------------------
448 // exceptions support
449 // ----------------------------------------------------------------------------
451 bool wxAppConsoleBase::OnExceptionInMainLoop()
455 // some compilers are too stupid to know that we never return after throw
456 #if defined(__DMC__) || (defined(_MSC_VER) && _MSC_VER < 1200)
461 #endif // wxUSE_EXCEPTIONS
463 // ----------------------------------------------------------------------------
465 // ----------------------------------------------------------------------------
467 #if wxUSE_CMDLINE_PARSER
469 #define OPTION_VERBOSE "verbose"
471 void wxAppConsoleBase::OnInitCmdLine(wxCmdLineParser
& parser
)
473 // the standard command line options
474 static const wxCmdLineEntryDesc cmdLineDesc
[] =
480 gettext_noop("show this help message"),
482 wxCMD_LINE_OPTION_HELP
490 gettext_noop("generate verbose log messages"),
500 parser
.SetDesc(cmdLineDesc
);
503 bool wxAppConsoleBase::OnCmdLineParsed(wxCmdLineParser
& parser
)
506 if ( parser
.Found(OPTION_VERBOSE
) )
508 wxLog::SetVerbose(true);
517 bool wxAppConsoleBase::OnCmdLineHelp(wxCmdLineParser
& parser
)
524 bool wxAppConsoleBase::OnCmdLineError(wxCmdLineParser
& parser
)
531 #endif // wxUSE_CMDLINE_PARSER
533 // ----------------------------------------------------------------------------
535 // ----------------------------------------------------------------------------
538 bool wxAppConsoleBase::CheckBuildOptions(const char *optionsSignature
,
539 const char *componentName
)
541 #if 0 // can't use wxLogTrace, not up and running yet
542 printf("checking build options object '%s' (ptr %p) in '%s'\n",
543 optionsSignature
, optionsSignature
, componentName
);
546 if ( strcmp(optionsSignature
, WX_BUILD_OPTIONS_SIGNATURE
) != 0 )
548 wxString lib
= wxString::FromAscii(WX_BUILD_OPTIONS_SIGNATURE
);
549 wxString prog
= wxString::FromAscii(optionsSignature
);
550 wxString progName
= wxString::FromAscii(componentName
);
553 msg
.Printf(_T("Mismatch between the program and library build versions detected.\nThe library used %s,\nand %s used %s."),
554 lib
.c_str(), progName
.c_str(), prog
.c_str());
556 wxLogFatalError(msg
.c_str());
558 // normally wxLogFatalError doesn't return
568 void wxAppConsoleBase::OnAssertFailure(const wxChar
*file
,
574 ShowAssertDialog(file
, line
, func
, cond
, msg
, GetTraits());
577 void wxAppConsoleBase::OnAssert(const wxChar
*file
,
582 OnAssertFailure(file
, line
, NULL
, cond
, msg
);
585 #endif // __WXDEBUG__
587 // ============================================================================
588 // other classes implementations
589 // ============================================================================
591 // ----------------------------------------------------------------------------
592 // wxConsoleAppTraitsBase
593 // ----------------------------------------------------------------------------
597 wxLog
*wxConsoleAppTraitsBase::CreateLogTarget()
599 return new wxLogStderr
;
604 wxMessageOutput
*wxConsoleAppTraitsBase::CreateMessageOutput()
606 return new wxMessageOutputStderr
;
611 wxFontMapper
*wxConsoleAppTraitsBase::CreateFontMapper()
613 return (wxFontMapper
*)new wxFontMapperBase
;
616 #endif // wxUSE_FONTMAP
618 wxRendererNative
*wxConsoleAppTraitsBase::CreateRenderer()
620 // console applications don't use renderers
625 bool wxConsoleAppTraitsBase::ShowAssertDialog(const wxString
& msg
)
627 return wxAppTraitsBase::ShowAssertDialog(msg
);
631 bool wxConsoleAppTraitsBase::HasStderr()
633 // console applications always have stderr, even under Mac/Windows
637 void wxConsoleAppTraitsBase::ScheduleForDestroy(wxObject
*object
)
642 void wxConsoleAppTraitsBase::RemoveFromPendingDelete(wxObject
* WXUNUSED(object
))
648 GSocketGUIFunctionsTable
* wxConsoleAppTraitsBase::GetSocketGUIFunctionsTable()
654 // ----------------------------------------------------------------------------
656 // ----------------------------------------------------------------------------
659 void wxAppTraitsBase::SetLocale()
661 wxSetlocale(LC_ALL
, "");
662 wxUpdateLocaleIsUtf8();
668 bool wxAppTraitsBase::ShowAssertDialog(const wxString
& msgOriginal
)
670 wxString msg
= msgOriginal
;
672 #if wxUSE_STACKWALKER
673 #if !defined(__WXMSW__)
674 // on Unix stack frame generation may take some time, depending on the
675 // size of the executable mainly... warn the user that we are working
676 wxFprintf(stderr
, wxT("[Debug] Generating a stack trace... please wait"));
680 const wxString stackTrace
= GetAssertStackTrace();
681 if ( !stackTrace
.empty() )
682 msg
<< _T("\n\nCall stack:\n") << stackTrace
;
683 #endif // wxUSE_STACKWALKER
685 return DoShowAssertDialog(msg
);
688 #if wxUSE_STACKWALKER
689 wxString
wxAppTraitsBase::GetAssertStackTrace()
693 class StackDump
: public wxStackWalker
698 const wxString
& GetStackTrace() const { return m_stackTrace
; }
701 virtual void OnStackFrame(const wxStackFrame
& frame
)
703 m_stackTrace
<< wxString::Format
706 wx_truncate_cast(int, frame
.GetLevel())
709 wxString name
= frame
.GetName();
712 m_stackTrace
<< wxString::Format(_T("%-40s"), name
.c_str());
716 m_stackTrace
<< wxString::Format(_T("%p"), frame
.GetAddress());
719 if ( frame
.HasSourceLocation() )
721 m_stackTrace
<< _T('\t')
722 << frame
.GetFileName()
727 m_stackTrace
<< _T('\n');
731 wxString m_stackTrace
;
734 // don't show more than maxLines or we could get a dialog too tall to be
735 // shown on screen: 20 should be ok everywhere as even with 15 pixel high
736 // characters it is still only 300 pixels...
737 static const int maxLines
= 20;
740 dump
.Walk(2, maxLines
); // don't show OnAssert() call itself
741 stackTrace
= dump
.GetStackTrace();
743 const int count
= stackTrace
.Freq(wxT('\n'));
744 for ( int i
= 0; i
< count
- maxLines
; i
++ )
745 stackTrace
= stackTrace
.BeforeLast(wxT('\n'));
749 #endif // wxUSE_STACKWALKER
752 #endif // __WXDEBUG__
754 // ============================================================================
755 // global functions implementation
756 // ============================================================================
766 // what else can we do?
775 wxTheApp
->WakeUpIdle();
777 //else: do nothing, what can we do?
783 bool wxAssertIsEqual(int x
, int y
)
788 // break into the debugger
791 #if defined(__WXMSW__) && !defined(__WXMICROWIN__)
793 #elif defined(_MSL_USING_MW_C_HEADERS) && _MSL_USING_MW_C_HEADERS
795 #elif defined(__UNIX__)
802 // this function is called when an assert fails
803 static void wxDoOnAssert(const wxString
& szFile
,
805 const wxString
& szFunc
,
806 const wxString
& szCond
,
807 const wxString
& szMsg
= wxEmptyString
)
810 static bool s_bInAssert
= false;
814 // He-e-e-e-elp!! we're trapped in endless loop
826 // by default, show the assert dialog box -- we can't customize this
828 ShowAssertDialog(szFile
, nLine
, szFunc
, szCond
, szMsg
);
832 // let the app process it as it wants
833 // FIXME-UTF8: use wc_str(), not c_str(), when ANSI build is removed
834 wxTheApp
->OnAssertFailure(szFile
.c_str(), nLine
, szFunc
.c_str(),
835 szCond
.c_str(), szMsg
.c_str());
841 void wxOnAssert(const wxString
& szFile
,
843 const wxString
& szFunc
,
844 const wxString
& szCond
,
845 const wxString
& szMsg
)
847 wxDoOnAssert(szFile
, nLine
, szFunc
, szCond
, szMsg
);
850 void wxOnAssert(const wxString
& szFile
,
852 const wxString
& szFunc
,
853 const wxString
& szCond
)
855 wxDoOnAssert(szFile
, nLine
, szFunc
, szCond
);
858 void wxOnAssert(const wxChar
*szFile
,
861 const wxChar
*szCond
,
864 wxDoOnAssert(szFile
, nLine
, szFunc
, szCond
, szMsg
);
867 void wxOnAssert(const char *szFile
,
871 const wxString
& szMsg
)
873 wxDoOnAssert(szFile
, nLine
, szFunc
, szCond
, szMsg
);
876 void wxOnAssert(const char *szFile
,
880 const wxCStrData
& msg
)
882 wxDoOnAssert(szFile
, nLine
, szFunc
, szCond
, msg
);
886 void wxOnAssert(const char *szFile
,
891 wxDoOnAssert(szFile
, nLine
, szFunc
, szCond
);
894 void wxOnAssert(const char *szFile
,
900 wxDoOnAssert(szFile
, nLine
, szFunc
, szCond
, szMsg
);
903 void wxOnAssert(const char *szFile
,
909 wxDoOnAssert(szFile
, nLine
, szFunc
, szCond
, szMsg
);
911 #endif // wxUSE_UNICODE
913 #endif // __WXDEBUG__
915 // ============================================================================
916 // private functions implementation
917 // ============================================================================
921 static void LINKAGEMODE
SetTraceMasks()
925 if ( wxGetEnv(wxT("WXTRACE"), &mask
) )
927 wxStringTokenizer
tkn(mask
, wxT(",;:"));
928 while ( tkn
.HasMoreTokens() )
929 wxLog::AddTraceMask(tkn
.GetNextToken());
935 bool DoShowAssertDialog(const wxString
& msg
)
937 // under MSW we can show the dialog even in the console mode
938 #if defined(__WXMSW__) && !defined(__WXMICROWIN__)
939 wxString
msgDlg(msg
);
941 // this message is intentionally not translated -- it is for
943 msgDlg
+= wxT("\nDo you want to stop the program?\n")
944 wxT("You can also choose [Cancel] to suppress ")
945 wxT("further warnings.");
947 switch ( ::MessageBox(NULL
, msgDlg
.wx_str(), _T("wxWidgets Debug Alert"),
948 MB_YESNOCANCEL
| MB_ICONSTOP
) )
958 //case IDNO: nothing to do
961 wxFprintf(stderr
, wxT("%s\n"), msg
.c_str());
964 // TODO: ask the user to enter "Y" or "N" on the console?
966 #endif // __WXMSW__/!__WXMSW__
968 // continue with the asserts
972 // show the assert modal dialog
974 void ShowAssertDialog(const wxString
& szFile
,
976 const wxString
& szFunc
,
977 const wxString
& szCond
,
978 const wxString
& szMsg
,
981 // this variable can be set to true to suppress "assert failure" messages
982 static bool s_bNoAsserts
= false;
987 // make life easier for people using VC++ IDE by using this format: like
988 // this, clicking on the message will take us immediately to the place of
990 msg
.Printf(wxT("%s(%d): assert \"%s\" failed"), szFile
, nLine
, szCond
);
992 // add the function name, if any
993 if ( !szFunc
.empty() )
994 msg
<< _T(" in ") << szFunc
<< _T("()");
996 // and the message itself
997 if ( !szMsg
.empty() )
999 msg
<< _T(": ") << szMsg
;
1001 else // no message given
1007 // if we are not in the main thread, output the assert directly and trap
1008 // since dialogs cannot be displayed
1009 if ( !wxThread::IsMain() )
1011 msg
+= wxT(" [in child thread]");
1013 #if defined(__WXMSW__) && !defined(__WXMICROWIN__)
1015 OutputDebugString(msg
.wx_str());
1018 wxFprintf(stderr
, wxT("%s\n"), msg
.c_str());
1021 // He-e-e-e-elp!! we're asserting in a child thread
1025 #endif // wxUSE_THREADS
1027 if ( !s_bNoAsserts
)
1029 // send it to the normal log destination
1030 wxLogDebug(_T("%s"), msg
.c_str());
1034 // delegate showing assert dialog (if possible) to that class
1035 s_bNoAsserts
= traits
->ShowAssertDialog(msg
);
1037 else // no traits object
1039 // fall back to the function of last resort
1040 s_bNoAsserts
= DoShowAssertDialog(msg
);
1045 #endif // __WXDEBUG__