]> git.saurik.com Git - wxWidgets.git/blob - src/common/init.cpp
Fix bugs in parsing wxLongLong values starting with zeroes.
[wxWidgets.git] / src / common / init.cpp
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/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
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 // ============================================================================
13 // declarations
14 // ============================================================================
15
16 // ----------------------------------------------------------------------------
17 // headers
18 // ----------------------------------------------------------------------------
19
20 #include "wx/wxprec.h"
21
22 #ifdef __BORLANDC__
23 #pragma hdrstop
24 #endif //__BORLANDC__
25
26 #ifndef WX_PRECOMP
27 #include "wx/app.h"
28 #include "wx/filefn.h"
29 #include "wx/log.h"
30 #include "wx/intl.h"
31 #include "wx/module.h"
32 #endif
33
34 #include "wx/init.h"
35 #include "wx/thread.h"
36
37 #include "wx/scopedptr.h"
38 #include "wx/except.h"
39
40 #if defined(__WINDOWS__)
41 #include "wx/msw/private.h"
42 #include "wx/msw/msvcrt.h"
43
44 #ifdef wxCrtSetDbgFlag
45 static struct EnableMemLeakChecking
46 {
47 EnableMemLeakChecking()
48 {
49 // check for memory leaks on program exit (another useful flag
50 // is _CRTDBG_DELAY_FREE_MEM_DF which doesn't free deallocated
51 // memory which may be used to simulate low-memory condition)
52 wxCrtSetDbgFlag(_CRTDBG_LEAK_CHECK_DF);
53 }
54 } gs_enableLeakChecks;
55 #endif // wxCrtSetDbgFlag
56 #endif // __WINDOWS__
57
58 // ----------------------------------------------------------------------------
59 // private classes
60 // ----------------------------------------------------------------------------
61
62 // we need a dummy app object if the user doesn't want to create a real one
63 class wxDummyConsoleApp : public wxAppConsole
64 {
65 public:
66 wxDummyConsoleApp() { }
67
68 virtual int OnRun() { wxFAIL_MSG( wxT("unreachable code") ); return 0; }
69 virtual bool DoYield(bool, long) { return true; }
70
71 wxDECLARE_NO_COPY_CLASS(wxDummyConsoleApp);
72 };
73
74 // we need a special kind of auto pointer to wxApp which not only deletes the
75 // pointer it holds in its dtor but also resets the global application pointer
76 wxDECLARE_SCOPED_PTR(wxAppConsole, wxAppPtrBase)
77 wxDEFINE_SCOPED_PTR(wxAppConsole, wxAppPtrBase)
78
79 class wxAppPtr : public wxAppPtrBase
80 {
81 public:
82 wxEXPLICIT wxAppPtr(wxAppConsole *ptr = NULL) : wxAppPtrBase(ptr) { }
83 ~wxAppPtr()
84 {
85 if ( get() )
86 {
87 // the pointer is going to be deleted in the base class dtor, don't
88 // leave the dangling pointer!
89 wxApp::SetInstance(NULL);
90 }
91 }
92
93 void Set(wxAppConsole *ptr)
94 {
95 reset(ptr);
96
97 wxApp::SetInstance(ptr);
98 }
99
100 wxDECLARE_NO_COPY_CLASS(wxAppPtr);
101 };
102
103 // class to ensure that wxAppBase::CleanUp() is called if our Initialize()
104 // fails
105 class wxCallAppCleanup
106 {
107 public:
108 wxCallAppCleanup(wxAppConsole *app) : m_app(app) { }
109 ~wxCallAppCleanup() { if ( m_app ) m_app->CleanUp(); }
110
111 void Dismiss() { m_app = NULL; }
112
113 private:
114 wxAppConsole *m_app;
115 };
116
117 // ----------------------------------------------------------------------------
118 // private functions
119 // ----------------------------------------------------------------------------
120
121 // suppress warnings about unused variables
122 static inline void Use(void *) { }
123
124 #define WX_SUPPRESS_UNUSED_WARN(x) Use(&x)
125
126 // ----------------------------------------------------------------------------
127 // initialization data
128 // ----------------------------------------------------------------------------
129
130 static struct InitData
131 {
132 InitData()
133 {
134 nInitCount = 0;
135
136 #if wxUSE_UNICODE
137 argc = 0;
138 // argv = NULL; -- not even really needed
139 #endif // wxUSE_UNICODE
140 }
141
142 // critical section protecting this struct
143 wxCRIT_SECT_DECLARE_MEMBER(csInit);
144
145 // number of times wxInitialize() was called minus the number of times
146 // wxUninitialize() was
147 size_t nInitCount;
148
149 #if wxUSE_UNICODE
150 int argc;
151
152 // if we receive the command line arguments as ASCII and have to convert
153 // them to Unicode ourselves (this is the case under Unix but not Windows,
154 // for example), we remember the converted argv here because we'll have to
155 // free it when doing cleanup to avoid memory leaks
156 wchar_t **argv;
157 #endif // wxUSE_UNICODE
158
159 wxDECLARE_NO_COPY_CLASS(InitData);
160 } gs_initData;
161
162 // ============================================================================
163 // implementation
164 // ============================================================================
165
166 // ----------------------------------------------------------------------------
167 // command line arguments ANSI -> Unicode conversion
168 // ----------------------------------------------------------------------------
169
170 #if wxUSE_UNICODE
171
172 static void ConvertArgsToUnicode(int argc, char **argv)
173 {
174 gs_initData.argv = new wchar_t *[argc + 1];
175 int wargc = 0;
176 for ( int i = 0; i < argc; i++ )
177 {
178 #ifdef __DARWIN__
179 wxWCharBuffer buf(wxConvFileName->cMB2WX(argv[i]));
180 #else
181 wxWCharBuffer buf(wxConvLocal.cMB2WX(argv[i]));
182 #endif
183 if ( !buf )
184 {
185 wxLogWarning(_("Command line argument %d couldn't be converted to Unicode and will be ignored."),
186 i);
187 }
188 else // converted ok
189 {
190 gs_initData.argv[wargc++] = wxStrdup(buf);
191 }
192 }
193
194 gs_initData.argc = wargc;
195 gs_initData.argv[wargc] = NULL;
196 }
197
198 static void FreeConvertedArgs()
199 {
200 if ( gs_initData.argv )
201 {
202 for ( int i = 0; i < gs_initData.argc; i++ )
203 {
204 free(gs_initData.argv[i]);
205 }
206
207 wxDELETEA(gs_initData.argv);
208 gs_initData.argc = 0;
209 }
210 }
211
212 #endif // wxUSE_UNICODE
213
214 // ----------------------------------------------------------------------------
215 // start up
216 // ----------------------------------------------------------------------------
217
218 // initialization which is always done (not customizable) before wxApp creation
219 static bool DoCommonPreInit()
220 {
221 #if wxUSE_UNICODE && defined(__WXOSX__)
222 // In OS X and iOS, wchar_t CRT functions convert to char* and fail under
223 // some locales. The safest fix is to set LC_CTYPE to UTF-8 to ensure that
224 // they can handle any input.
225 //
226 // Note that this must be done for any app, Cocoa or console, whether or
227 // not it uses wxLocale.
228 //
229 // See http://stackoverflow.com/questions/11713745/why-does-the-printf-family-of-functions-care-about-locale
230 setlocale(LC_CTYPE, "UTF-8");
231 #endif // wxUSE_UNICODE && defined(__WXOSX__)
232
233 #if wxUSE_LOG
234 // Reset logging in case we were cleaned up and are being reinitialized.
235 wxLog::DoCreateOnDemand();
236
237 // force wxLog to create a log target now: we do it because wxTheApp
238 // doesn't exist yet so wxLog will create a special log target which is
239 // safe to use even when the GUI is not available while without this call
240 // we could create wxApp in wxEntryStart() below, then log an error about
241 // e.g. failure to establish connection to the X server and wxLog would
242 // send it to wxLogGui (because wxTheApp does exist already) which, of
243 // course, can't be used in this case
244 //
245 // notice also that this does nothing if the user had set up a custom log
246 // target before -- which is fine as we want to give him this possibility
247 // (as it's impossible to override logging by overriding wxAppTraits::
248 // CreateLogTarget() before wxApp is created) and we just assume he knows
249 // what he is doing
250 wxLog::GetActiveTarget();
251 #endif // wxUSE_LOG
252
253 #ifdef __WINDOWS__
254 // GUI applications obtain HINSTANCE in their WinMain() but we also need to
255 // initialize the global wxhInstance variable for the console programs as
256 // they may need it too, so set it here if it wasn't done yet
257 if ( !wxGetInstance() )
258 {
259 wxSetInstance(::GetModuleHandle(NULL));
260 }
261 #endif // __WINDOWS__
262
263 return true;
264 }
265
266 // non customizable initialization done after wxApp creation and initialization
267 static bool DoCommonPostInit()
268 {
269 wxModule::RegisterModules();
270
271 if ( !wxModule::InitializeModules() )
272 {
273 wxLogError(_("Initialization failed in post init, aborting."));
274 return false;
275 }
276
277 return true;
278 }
279
280 bool wxEntryStart(int& argc, wxChar **argv)
281 {
282 // do minimal, always necessary, initialization
283 // --------------------------------------------
284
285 // initialize wxRTTI
286 if ( !DoCommonPreInit() )
287 return false;
288
289
290 // first of all, we need an application object
291 // -------------------------------------------
292
293 // the user might have already created it himself somehow
294 wxAppPtr app(wxTheApp);
295 if ( !app.get() )
296 {
297 // if not, he might have used IMPLEMENT_APP() to give us a function to
298 // create it
299 wxAppInitializerFunction fnCreate = wxApp::GetInitializerFunction();
300
301 if ( fnCreate )
302 {
303 // he did, try to create the custom wxApp object
304 app.Set((*fnCreate)());
305 }
306 }
307
308 if ( !app.get() )
309 {
310 // either IMPLEMENT_APP() was not used at all or it failed -- in any
311 // case we still need something
312 app.Set(new wxDummyConsoleApp);
313 }
314
315
316 // wxApp initialization: this can be customized
317 // --------------------------------------------
318
319 if ( !app->Initialize(argc, argv) )
320 return false;
321
322 // remember, possibly modified (e.g. due to removal of toolkit-specific
323 // parameters), command line arguments in member variables
324 app->argc = argc;
325 app->argv = argv;
326
327 wxCallAppCleanup callAppCleanup(app.get());
328
329
330 // common initialization after wxTheApp creation
331 // ---------------------------------------------
332
333 if ( !DoCommonPostInit() )
334 return false;
335
336
337 // prevent the smart pointer from destroying its contents
338 app.release();
339
340 // and the cleanup object from doing cleanup
341 callAppCleanup.Dismiss();
342
343 #if wxUSE_LOG
344 // now that we have a valid wxApp (wxLogGui would have crashed if we used
345 // it before now), we can delete the temporary sink we had created for the
346 // initialization messages -- the next time logging function is called, the
347 // sink will be recreated but this time wxAppTraits will be used
348 delete wxLog::SetActiveTarget(NULL);
349 #endif // wxUSE_LOG
350
351 return true;
352 }
353
354 #if wxUSE_UNICODE
355
356 // we provide a wxEntryStart() wrapper taking "char *" pointer too
357 bool wxEntryStart(int& argc, char **argv)
358 {
359 ConvertArgsToUnicode(argc, argv);
360
361 if ( !wxEntryStart(gs_initData.argc, gs_initData.argv) )
362 {
363 FreeConvertedArgs();
364
365 return false;
366 }
367
368 return true;
369 }
370
371 #endif // wxUSE_UNICODE
372
373 // ----------------------------------------------------------------------------
374 // clean up
375 // ----------------------------------------------------------------------------
376
377 // cleanup done before destroying wxTheApp
378 static void DoCommonPreCleanup()
379 {
380 #if wxUSE_LOG
381 // flush the logged messages if any and don't use the current probably
382 // unsafe log target any more: the default one (wxLogGui) can't be used
383 // after the resources are freed which happens when we return and the user
384 // supplied one might be even more unsafe (using any wxWidgets GUI function
385 // is unsafe starting from now)
386 //
387 // notice that wxLog will still recreate a default log target if any
388 // messages are logged but that one will be safe to use until the very end
389 delete wxLog::SetActiveTarget(NULL);
390 #endif // wxUSE_LOG
391 }
392
393 // cleanup done after destroying wxTheApp
394 static void DoCommonPostCleanup()
395 {
396 wxModule::CleanUpModules();
397
398 // we can't do this in wxApp itself because it doesn't know if argv had
399 // been allocated
400 #if wxUSE_UNICODE
401 FreeConvertedArgs();
402 #endif // wxUSE_UNICODE
403
404 // use Set(NULL) and not Get() to avoid creating a message output object on
405 // demand when we just want to delete it
406 delete wxMessageOutput::Set(NULL);
407
408 #if wxUSE_LOG
409 // and now delete the last logger as well
410 //
411 // we still don't disable log target auto-vivification even if any log
412 // objects created now will result in memory leaks because it seems better
413 // to leak memory which doesn't matter much considering the application is
414 // exiting anyhow than to not show messages which could still be logged
415 // from the user code (e.g. static dtors and such)
416 delete wxLog::SetActiveTarget(NULL);
417 #endif // wxUSE_LOG
418 }
419
420 void wxEntryCleanup()
421 {
422 DoCommonPreCleanup();
423
424
425 // delete the application object
426 if ( wxTheApp )
427 {
428 wxTheApp->CleanUp();
429
430 // reset the global pointer to it to NULL before destroying it as in
431 // some circumstances this can result in executing the code using
432 // wxTheApp and using half-destroyed object is no good
433 wxAppConsole * const app = wxApp::GetInstance();
434 wxApp::SetInstance(NULL);
435 delete app;
436 }
437
438
439 DoCommonPostCleanup();
440 }
441
442 // ----------------------------------------------------------------------------
443 // wxEntry
444 // ----------------------------------------------------------------------------
445
446 // for MSW the real wxEntry is defined in msw/main.cpp
447 #ifndef __WINDOWS__
448 #define wxEntryReal wxEntry
449 #endif // !__WINDOWS__
450
451 int wxEntryReal(int& argc, wxChar **argv)
452 {
453 // library initialization
454 wxInitializer initializer(argc, argv);
455
456 if ( !initializer.IsOk() )
457 {
458 #if wxUSE_LOG
459 // flush any log messages explaining why we failed
460 delete wxLog::SetActiveTarget(NULL);
461 #endif
462 return -1;
463 }
464
465 wxTRY
466 {
467 // app initialization
468 if ( !wxTheApp->CallOnInit() )
469 {
470 // don't call OnExit() if OnInit() failed
471 return -1;
472 }
473
474 // ensure that OnExit() is called if OnInit() had succeeded
475 class CallOnExit
476 {
477 public:
478 ~CallOnExit() { wxTheApp->OnExit(); }
479 } callOnExit;
480
481 WX_SUPPRESS_UNUSED_WARN(callOnExit);
482
483 // app execution
484 return wxTheApp->OnRun();
485 }
486 wxCATCH_ALL( wxTheApp->OnUnhandledException(); return -1; )
487 }
488
489 #if wxUSE_UNICODE
490
491 // as with wxEntryStart, we provide an ANSI wrapper
492 int wxEntry(int& argc, char **argv)
493 {
494 ConvertArgsToUnicode(argc, argv);
495
496 return wxEntry(gs_initData.argc, gs_initData.argv);
497 }
498
499 #endif // wxUSE_UNICODE
500
501 // ----------------------------------------------------------------------------
502 // wxInitialize/wxUninitialize
503 // ----------------------------------------------------------------------------
504
505 bool wxInitialize()
506 {
507 return wxInitialize(0, (wxChar**)NULL);
508 }
509
510 bool wxInitialize(int argc, wxChar **argv)
511 {
512 wxCRIT_SECT_LOCKER(lockInit, gs_initData.csInit);
513
514 if ( gs_initData.nInitCount++ )
515 {
516 // already initialized
517 return true;
518 }
519
520 return wxEntryStart(argc, argv);
521 }
522
523 #if wxUSE_UNICODE
524 bool wxInitialize(int argc, char **argv)
525 {
526 wxCRIT_SECT_LOCKER(lockInit, gs_initData.csInit);
527
528 if ( gs_initData.nInitCount++ )
529 {
530 // already initialized
531 return true;
532 }
533
534 return wxEntryStart(argc, argv);
535 }
536 #endif // wxUSE_UNICODE
537
538 void wxUninitialize()
539 {
540 wxCRIT_SECT_LOCKER(lockInit, gs_initData.csInit);
541
542 if ( --gs_initData.nInitCount == 0 )
543 {
544 wxEntryCleanup();
545 }
546 }