]> git.saurik.com Git - wxWidgets.git/blame - src/common/init.cpp
fixed Mach-O compilation
[wxWidgets.git] / src / common / init.cpp
CommitLineData
e90c1d2a
VZ
1/////////////////////////////////////////////////////////////////////////////
2// Name: common/init.cpp
3// Purpose: initialisation for the library
4// Author: Vadim Zeitlin
5// Modified by:
6// Created: 04.10.99
7// RCS-ID: $Id$
8// Copyright: (c) Vadim Zeitlin
65571936 9// Licence: wxWindows licence
e90c1d2a
VZ
10/////////////////////////////////////////////////////////////////////////////
11
12// ============================================================================
13// declarations
14// ============================================================================
15
16// ----------------------------------------------------------------------------
17// headers
18// ----------------------------------------------------------------------------
19
f4c890fd
JS
20#include "wx/wxprec.h"
21
22#ifdef __BORLANDC__
23 #pragma hdrstop
24#endif //__BORLANDC__
25
e87271f3
VZ
26#ifndef WX_PRECOMP
27 #include "wx/app.h"
28 #include "wx/debug.h"
bc385ba9 29 #include "wx/filefn.h"
e2450fa9 30 #include "wx/log.h"
94826170 31 #include "wx/thread.h"
e87271f3 32#endif
e90c1d2a 33
abca8ebf
VZ
34#include "wx/init.h"
35
94826170 36#include "wx/ptr_scpd.h"
51abe921 37#include "wx/module.h"
fb3e83b6 38#include "wx/except.h"
51abe921 39
94826170
VZ
40#if defined(__WXMSW__) && defined(__WXDEBUG__)
41 #include "wx/msw/msvcrt.h"
42
43 static struct EnableMemLeakChecking
44 {
45 EnableMemLeakChecking()
46 {
47 // do check for memory leaks on program exit (another useful flag
48 // is _CRTDBG_DELAY_FREE_MEM_DF which doesn't free deallocated
49 // memory which may be used to simulate low-memory condition)
50 wxCrtSetDbgFlag(_CRTDBG_LEAK_CHECK_DF);
51 }
52 } gs_enableLeakChecks;
53#endif // __WXMSW__ && __WXDEBUG__
54
e90c1d2a
VZ
55// ----------------------------------------------------------------------------
56// private classes
57// ----------------------------------------------------------------------------
58
e2478fde 59// we need a dummy app object if the user doesn't want to create a real one
94826170 60class wxDummyConsoleApp : public wxAppConsole
e90c1d2a
VZ
61{
62public:
fc7a2a60
VZ
63 wxDummyConsoleApp() { }
64
e2478fde 65 virtual int OnRun() { wxFAIL_MSG( _T("unreachable code") ); return 0; }
fc7a2a60
VZ
66
67 DECLARE_NO_COPY_CLASS(wxDummyConsoleApp)
e90c1d2a
VZ
68};
69
94826170 70// we need a special kind of auto pointer to wxApp which not only deletes the
7cafd224 71// pointer it holds in its dtor but also resets the global application pointer
77c6966e
VS
72wxDECLARE_SCOPED_PTR(wxAppConsole, wxAppPtrBase);
73wxDEFINE_SCOPED_PTR(wxAppConsole, wxAppPtrBase);
bc385ba9 74
94826170
VZ
75class wxAppPtr : public wxAppPtrBase
76{
77public:
77c6966e 78 wxEXPLICIT wxAppPtr(wxAppConsole *ptr = NULL) : wxAppPtrBase(ptr) { }
94826170
VZ
79 ~wxAppPtr()
80 {
81 if ( get() )
82 {
83 // the pointer is going to be deleted in the base class dtor, don't
84 // leave the dangling pointer!
a80e5f9e 85 wxApp::SetInstance(NULL);
94826170
VZ
86 }
87 }
88
77c6966e 89 void Set(wxAppConsole *ptr)
94826170
VZ
90 {
91 reset(ptr);
92
a80e5f9e 93 wxApp::SetInstance(ptr);
94826170 94 }
fc7a2a60
VZ
95
96 DECLARE_NO_COPY_CLASS(wxAppPtr)
94826170
VZ
97};
98
05e2b077
VZ
99// class to ensure that wxAppBase::CleanUp() is called if our Initialize()
100// fails
101class wxCallAppCleanup
102{
103public:
77c6966e 104 wxCallAppCleanup(wxAppConsole *app) : m_app(app) { }
05e2b077
VZ
105 ~wxCallAppCleanup() { if ( m_app ) m_app->CleanUp(); }
106
107 void Dismiss() { m_app = NULL; }
108
109private:
77c6966e 110 wxAppConsole *m_app;
05e2b077
VZ
111};
112
94826170
VZ
113// another tiny class which simply exists to ensure that wxEntryCleanup is
114// always called
115class wxCleanupOnExit
116{
117public:
118 ~wxCleanupOnExit() { wxEntryCleanup(); }
119};
bc385ba9 120
005b5298
VZ
121// ----------------------------------------------------------------------------
122// private functions
123// ----------------------------------------------------------------------------
124
125// suppress warnings about unused variables
126static inline void Use(void *) { }
127
128#define WX_SUPPRESS_UNUSED_WARN(x) Use(&x)
129
e90c1d2a 130// ----------------------------------------------------------------------------
94826170 131// initialization data
e90c1d2a
VZ
132// ----------------------------------------------------------------------------
133
94826170
VZ
134static struct InitData
135{
136 InitData()
137 {
138 nInitCount = 0;
139
140#if wxUSE_UNICODE
141 argc = 0;
142 // argv = NULL; -- not even really needed
143#endif // wxUSE_UNICODE
144 }
145
146 // critical section protecting this struct
147 wxCRIT_SECT_DECLARE_MEMBER(csInit);
148
149 // number of times wxInitialize() was called minus the number of times
150 // wxUninitialize() was
151 size_t nInitCount;
152
153#if wxUSE_UNICODE
154 int argc;
155
156 // if we receive the command line arguments as ASCII and have to convert
157 // them to Unicode ourselves (this is the case under Unix but not Windows,
158 // for example), we remember the converted argv here because we'll have to
159 // free it when doing cleanup to avoid memory leaks
150cb195 160 wchar_t **argv;
94826170 161#endif // wxUSE_UNICODE
fc7a2a60
VZ
162
163 DECLARE_NO_COPY_CLASS(InitData)
94826170 164} gs_initData;
e90c1d2a
VZ
165
166// ============================================================================
167// implementation
168// ============================================================================
169
252a752e 170// ----------------------------------------------------------------------------
94826170 171// command line arguments ANSI -> Unicode conversion
252a752e
VZ
172// ----------------------------------------------------------------------------
173
94826170
VZ
174#if wxUSE_UNICODE
175
176static void ConvertArgsToUnicode(int argc, char **argv)
e90c1d2a 177{
94826170
VZ
178 gs_initData.argv = new wchar_t *[argc + 1];
179 for ( int i = 0; i < argc; i++ )
e90c1d2a 180 {
94826170 181 gs_initData.argv[i] = wxStrdup(wxConvLocal.cMB2WX(argv[i]));
e90c1d2a
VZ
182 }
183
08989e30 184 gs_initData.argc = argc;
94826170
VZ
185 gs_initData.argv[argc] = NULL;
186}
e90c1d2a 187
94826170
VZ
188static void FreeConvertedArgs()
189{
150cb195 190 if ( gs_initData.argv )
bbfa0322 191 {
150cb195
VZ
192 for ( int i = 0; i < gs_initData.argc; i++ )
193 {
194 free(gs_initData.argv[i]);
195 }
196
197 delete [] gs_initData.argv;
198 gs_initData.argv = NULL;
08989e30 199 gs_initData.argc = 0;
bbfa0322 200 }
94826170 201}
bbfa0322 202
94826170 203#endif // wxUSE_UNICODE
e90c1d2a 204
94826170
VZ
205// ----------------------------------------------------------------------------
206// start up
207// ----------------------------------------------------------------------------
bbfa0322 208
94826170
VZ
209// initialization which is always done (not customizable) before wxApp creation
210static bool DoCommonPreInit()
211{
94826170 212 return true;
e90c1d2a
VZ
213}
214
94826170
VZ
215// non customizable initialization done after wxApp creation and initialization
216static bool DoCommonPostInit()
e90c1d2a 217{
94826170
VZ
218 wxModule::RegisterModules();
219
220 return wxModule::InitializeModules();
bc385ba9
VZ
221}
222
05e2b077 223bool wxEntryStart(int& argc, wxChar **argv)
bc385ba9 224{
94826170
VZ
225 // do minimal, always necessary, initialization
226 // --------------------------------------------
227
228 // initialize wxRTTI
229 if ( !DoCommonPreInit() )
bc385ba9 230 {
94826170 231 return false;
bc385ba9
VZ
232 }
233
bc385ba9 234
94826170
VZ
235 // first of all, we need an application object
236 // -------------------------------------------
237
238 // the user might have already created it himself somehow
239 wxAppPtr app(wxTheApp);
240 if ( !app.get() )
241 {
242 // if not, he might have used IMPLEMENT_APP() to give us a function to
243 // create it
bc385ba9
VZ
244 wxAppInitializerFunction fnCreate = wxApp::GetInitializerFunction();
245
94826170
VZ
246 if ( fnCreate )
247 {
248 // he did, try to create the custom wxApp object
7cafd224 249 app.Set((*fnCreate)());
94826170
VZ
250 }
251 }
252
253 if ( !app.get() )
254 {
255 // either IMPLEMENT_APP() was not used at all or it failed -- in any
256 // case we still need something
7cafd224 257 app.Set(new wxDummyConsoleApp);
bc385ba9
VZ
258 }
259
bc385ba9 260
94826170
VZ
261 // wxApp initialization: this can be customized
262 // --------------------------------------------
bc385ba9 263
7cafd224 264 if ( !app->Initialize(argc, argv) )
bc385ba9 265 {
94826170 266 return false;
bc385ba9 267 }
bc385ba9 268
7cafd224 269 wxCallAppCleanup callAppCleanup(app.get());
05e2b077
VZ
270
271 // for compatibility call the old initialization function too
7cafd224 272 if ( !app->OnInitGui() )
05e2b077
VZ
273 return false;
274
bc385ba9 275
94826170
VZ
276 // common initialization after wxTheApp creation
277 // ---------------------------------------------
bc385ba9 278
94826170 279 if ( !DoCommonPostInit() )
94826170 280 return false;
bc385ba9 281
bc385ba9 282
94826170
VZ
283 // prevent the smart pointer from destroying its contents
284 app.release();
285
05e2b077
VZ
286 // and the cleanup object from doing cleanup
287 callAppCleanup.Dismiss();
288
94826170 289 return true;
bc385ba9
VZ
290}
291
94826170 292#if wxUSE_UNICODE
bbfa0322 293
94826170 294// we provide a wxEntryStart() wrapper taking "char *" pointer too
05e2b077 295bool wxEntryStart(int& argc, char **argv)
bc385ba9 296{
94826170 297 ConvertArgsToUnicode(argc, argv);
bc385ba9 298
94826170 299 if ( !wxEntryStart(argc, gs_initData.argv) )
bc385ba9 300 {
94826170
VZ
301 FreeConvertedArgs();
302
303 return false;
e90c1d2a 304 }
bc385ba9 305
94826170 306 return true;
bc385ba9
VZ
307}
308
94826170
VZ
309#endif // wxUSE_UNICODE
310
311// ----------------------------------------------------------------------------
312// clean up
313// ----------------------------------------------------------------------------
314
7beb59f3 315// cleanup done before destroying wxTheApp
94826170 316static void DoCommonPreCleanup()
bc385ba9
VZ
317{
318#if wxUSE_LOG
94826170
VZ
319 // flush the logged messages if any and install a 'safer' log target: the
320 // default one (wxLogGui) can't be used after the resources are freed just
321 // below and the user supplied one might be even more unsafe (using any
77ffb593 322 // wxWidgets GUI function is unsafe starting from now)
8a9c2246 323 wxLog::DontCreateOnDemand();
94826170
VZ
324
325 // this will flush the old messages if any
8a9c2246 326 delete wxLog::SetActiveTarget(new wxLogStderr);
bc385ba9 327#endif // wxUSE_LOG
94826170 328}
bc385ba9 329
94826170
VZ
330// cleanup done after destroying wxTheApp
331static void DoCommonPostCleanup()
332{
a4de7e8c
VZ
333 wxModule::CleanUpModules();
334
cafc76a4 335 wxClassInfo::CleanUp();
bc385ba9 336
94826170
VZ
337 // we can't do this in wxApp itself because it doesn't know if argv had
338 // been allocated
90aaa865 339#if wxUSE_UNICODE
94826170 340 FreeConvertedArgs();
90aaa865
VZ
341#endif // wxUSE_UNICODE
342
ced55544 343 // Note: check for memory leaks is now done via wxDebugContextDumpDelayCounter
8a9c2246
VZ
344#if wxUSE_LOG
345 // and now delete the last logger as well
346 delete wxLog::SetActiveTarget(NULL);
347#endif // wxUSE_LOG
e90c1d2a 348}
e2450fa9 349
94826170
VZ
350void wxEntryCleanup()
351{
352 DoCommonPreCleanup();
353
354
355 // delete the application object
356 if ( wxTheApp )
357 {
358 wxTheApp->CleanUp();
359
360 delete wxTheApp;
a80e5f9e 361 wxApp::SetInstance(NULL);
94826170
VZ
362 }
363
364
365 DoCommonPostCleanup();
94826170
VZ
366}
367
368// ----------------------------------------------------------------------------
369// wxEntry
370// ----------------------------------------------------------------------------
371
226c11c0
VZ
372// for MSW the real wxEntry is defined in msw/main.cpp
373#ifndef __WXMSW__
94826170 374 #define wxEntryReal wxEntry
226c11c0 375#endif // !__WXMSW__
94826170 376
05e2b077 377int wxEntryReal(int& argc, wxChar **argv)
94826170 378{
58c5fe3b
KH
379#if wxUSE_LOG
380 // Create a non-GUI log target, to be used until GUI (if any) is ready.
381 // Target will be reset by wxAppConsole::Initialize, when GUI logging will work.
382 wxLog::GetActiveTarget();
383#endif
384
94826170
VZ
385 // library initialization
386 if ( !wxEntryStart(argc, argv) )
387 {
388 return -1;
389 }
390
391 // if wxEntryStart succeeded, we must call wxEntryCleanup even if the code
392 // below returns or throws
393 wxCleanupOnExit cleanupOnExit;
394
005b5298
VZ
395 WX_SUPPRESS_UNUSED_WARN(cleanupOnExit);
396
fb3e83b6 397 wxTRY
94826170 398 {
e83f2301 399
fb3e83b6
VZ
400 // app initialization
401 if ( !wxTheApp->CallOnInit() )
402 {
403 // don't call OnExit() if OnInit() failed
404 return -1;
405 }
94826170 406
fe277be0
VZ
407 // ensure that OnExit() is called if OnInit() had succeeded
408 class CallOnExit
409 {
410 public:
411 ~CallOnExit() { wxTheApp->OnExit(); }
412 } callOnExit;
94826170 413
9e9eea73
VZ
414 WX_SUPPRESS_UNUSED_WARN(callOnExit);
415
fe277be0
VZ
416 // app execution
417 return wxTheApp->OnRun();
fb3e83b6
VZ
418 }
419 wxCATCH_ALL( wxTheApp->OnUnhandledException(); return -1; )
94826170
VZ
420}
421
94826170
VZ
422#if wxUSE_UNICODE
423
424// as with wxEntryStart, we provide an ANSI wrapper
abca8ebf 425int wxEntry(int& argc, char **argv)
94826170
VZ
426{
427 ConvertArgsToUnicode(argc, argv);
428
429 return wxEntry(argc, gs_initData.argv);
430}
431
432#endif // wxUSE_UNICODE
433
434// ----------------------------------------------------------------------------
435// wxInitialize/wxUninitialize
436// ----------------------------------------------------------------------------
437
438bool wxInitialize(int argc, wxChar **argv)
439{
440 wxCRIT_SECT_LOCKER(lockInit, gs_initData.csInit);
441
442 if ( gs_initData.nInitCount++ )
443 {
444 // already initialized
445 return true;
446 }
447
448 return wxEntryStart(argc, argv);
449}
450
451void wxUninitialize()
452{
453 wxCRIT_SECT_LOCKER(lockInit, gs_initData.csInit);
454
455 if ( !--gs_initData.nInitCount )
456 {
457 wxEntryCleanup();
458 }
459}
460