src/common/object.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        object.cpp
   3 // Purpose:     wxObject implementation
   4 // Author:      Julian Smart
   5 // Modified by: Ron Lee
   6 // Created:     04/01/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 1998 Julian Smart and Markus Holzem
   9 //              (c) 2001 Ron Lee <ron@debian.org>
  10 // Licence:     wxWindows license
  11 /////////////////////////////////////////////////////////////////////////////
  12
  13 #ifdef __GNUG__
  14 #pragma implementation "object.h"
  15 #endif
  16
  17     // For compilers that support precompilation, includes "wx.h".
  18
  19 #include "wx/wxprec.h"
  20
  21 #ifdef __BORLANDC__
  22 #pragma hdrstop
  23 #endif
  24
  25 #ifndef WX_PRECOMP
  26 #include "wx/hash.h"
  27 #endif
  28
  29 #include <string.h>
  30 #include <assert.h>
  31
  32 #if (defined(__WXDEBUG__) && wxUSE_MEMORY_TRACING) || wxUSE_DEBUG_CONTEXT
  33 #include "wx/memory.h"
  34 #endif
  35
  36 #if defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT
  37     // for wxObject::Dump
  38 #include "wx/ioswrap.h"
  39
  40 #if defined(__VISAGECPP__)
  41 #define DEBUG_PRINTF(NAME) { static int raz=0; \
  42  printf( #NAME " %i\n",raz); fflush(stdout); raz++; }
  43 #else
  44 #define DEBUG_PRINTF(NAME)
  45 #endif
  46
  47 #endif
  48
  49
  50 wxClassInfo wxObject::sm_classwxObject( wxT("wxObject"), 0, 0,
  51                                         (int) sizeof(wxObject),
  52                                         (wxObjectConstructorFn) 0 );
  53 wxClassInfo* wxClassInfo::sm_first = 0;
  54 wxHashTable* wxClassInfo::sm_classTable = 0;
  55
  56     // These are here so we can avoid 'always true/false' warnings
  57     // by referring to these instead of TRUE/FALSE
  58
  59 const bool wxTrue = TRUE;
  60 const bool wxFalse = FALSE;
  61
  62     // Is this object a kind of (a subclass of) 'info'?
  63     // E.g. is wxWindow a kind of wxObject?
  64     // Go from this class to superclass, taking into account
  65     // two possible base classes.
  66
  67 bool wxObject::IsKindOf(wxClassInfo *info) const
  68 {
  69     wxClassInfo *thisInfo = GetClassInfo();
  70     return (thisInfo) ? thisInfo->IsKindOf(info) : FALSE ;
  71 }
  72
  73 #if wxUSE_STD_IOSTREAM && (defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT)
  74 void wxObject::Dump(wxSTD ostream& str)
  75 {
  76     if (GetClassInfo() && GetClassInfo()->GetClassName())
  77         str << GetClassInfo()->GetClassName();
  78     else
  79         str << "unknown object class";
  80 }
  81 #endif
  82
  83 #if defined(__WXDEBUG__) && wxUSE_MEMORY_TRACING
  84
  85 #ifdef new
  86 #undef new
  87 #endif
  88
  89 void *wxObject::operator new (size_t size, wxChar *fileName, int lineNum)
  90 {
  91     return wxDebugAlloc(size, fileName, lineNum, TRUE);
  92 }
  93
  94 #ifndef __VISAGECPP__
  95 void wxObject::operator delete (void *buf)
  96 {
  97     wxDebugFree(buf);
  98 }
  99 #elif __DEBUG_ALLOC__
 100 void wxObject::operator delete (void *buf, const char *_fname, size_t _line)
 101 {
 102     wxDebugFree(buf);
 103 }
 104 #endif
 105
 106     // VC++ 6.0
 107
 108 #if defined(__VISUALC__) && (__VISUALC__ >= 1200)
 109 void wxObject::operator delete(void *pData, wxChar *WXUNUSED(fileName), int WXUNUSED(lineNum))
 110 {
 111     ::operator delete(pData);
 112 }
 113 #endif
 114
 115     // Cause problems for VC++ - crashes
 116
 117 #if (!defined(__VISUALC__) && wxUSE_ARRAY_MEMORY_OPERATORS ) || defined(__MWERKS__)
 118 void *wxObject::operator new[] (size_t size, wxChar *fileName, int lineNum)
 119 {
 120     return wxDebugAlloc(size, fileName, lineNum, TRUE, TRUE);
 121 }
 122
 123 void wxObject::operator delete[] (void *buf)
 124 {
 125     wxDebugFree(buf, TRUE);
 126 }
 127 #endif
 128
 129 #endif  // __WXDEBUG__  && wxUSE_MEMORY_TRACING
 130
 131
 132 // ----------------------------------------------------------------------------
 133 // wxClassInfo
 134 // ----------------------------------------------------------------------------
 135
 136 wxClassInfo *wxClassInfo::FindClass(const wxChar *className)
 137 {
 138     if ( sm_classTable )
 139     {
 140         return (wxClassInfo *)wxClassInfo::sm_classTable->Get(className);
 141     }
 142     else
 143     {
 144         for ( wxClassInfo *info = sm_first; info ; info = info->m_next )
 145         {
 146             if ( wxStrcmp(info->GetClassName(), className) == 0 )
 147                 return info;
 148         }
 149
 150         return NULL;
 151     }
 152 }
 153
 154 // a tiny InitializeClasses() helper
 155 /* static */
 156 inline wxClassInfo *wxClassInfo::GetBaseByName(const wxChar *name)
 157 {
 158     if ( !name )
 159         return NULL;
 160
 161     wxClassInfo *classInfo = (wxClassInfo *)sm_classTable->Get(name);
 162
 163     // this must be fixed, other things risk work wrongly later if you get this
 164     wxASSERT_MSG( classInfo, _T("base class unknown to wxWindows RTTI") );
 165
 166     return classInfo;
 167 }
 168
 169 // Set pointers to base class(es) to speed up IsKindOf
 170 void wxClassInfo::InitializeClasses()
 171 {
 172     // using IMPLEMENT_DYNAMIC_CLASS() macro twice (which may happen if you
 173     // link any object module twice mistakenly) will break this function
 174     // because it will enter an infinite loop and eventually die with "out of
 175     // memory" - as this is quite hard to detect if you're unaware of this,
 176     // try to do some checks here
 177
 178 #ifdef __WXDEBUG__
 179     static const size_t nMaxClasses = 10000;    // more than we'll ever have
 180     size_t nClass = 0;
 181 #endif
 182
 183     wxClassInfo::sm_classTable = new wxHashTable(wxKEY_STRING);
 184
 185         // Index all class infos by their class name
 186
 187     wxClassInfo *info;
 188     for(info = sm_first; info; info = info->m_next)
 189     {
 190         if (info->m_className)
 191         {
 192             wxASSERT_MSG( ++nClass < nMaxClasses,
 193                           _T("an infinite loop detected - have you used IMPLEMENT_DYNAMIC_CLASS() twice (may be by linking some object module(s) twice)?") );
 194             sm_classTable->Put(info->m_className, (wxObject *)info);
 195         }
 196     }
 197
 198         // Set base pointers for each wxClassInfo
 199
 200     for(info = sm_first; info; info = info->m_next)
 201     {
 202         info->m_baseInfo1 = GetBaseByName(info->GetBaseClassName1());
 203         info->m_baseInfo2 = GetBaseByName(info->GetBaseClassName2());
 204     }
 205 }
 206
 207 void wxClassInfo::CleanUpClasses()
 208 {
 209     delete wxClassInfo::sm_classTable;
 210     wxClassInfo::sm_classTable = 0;
 211 }
 212
 213
 214 wxObject *wxCreateDynamicObject(const wxChar *name)
 215 {
 216 #if defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT
 217  DEBUG_PRINTF(wxObject *wxCreateDynamicObject)
 218 #endif
 219
 220     if (wxClassInfo::sm_classTable)
 221     {
 222         wxClassInfo *info = (wxClassInfo *)wxClassInfo::sm_classTable->Get(name);
 223         return info != 0 ? info->CreateObject() : 0;
 224     }
 225     else
 226     {
 227         for(wxClassInfo *info = wxClassInfo::sm_first; info; info = info->m_next)
 228             if (info->m_className && wxStrcmp(info->m_className, name) == 0)
 229                 return info->CreateObject();
 230         return 0;
 231     }
 232 }
 233
 234
 235 // ----------------------------------------------------------------------------
 236 // wxClassInfo
 237 // ----------------------------------------------------------------------------
 238
 239 void wxObject::Ref(const wxObject& clone)
 240 {
 241 #if defined(__WXDEBUG__) || wxUSE_DEBUG_CONTEXT
 242     DEBUG_PRINTF(wxObject::Ref)
 243 #endif
 244
 245     // nothing to be done
 246     if (m_refData == clone.m_refData)
 247         return;
 248
 249     // delete reference to old data
 250     UnRef();
 251
 252     // reference new data
 253     if ( clone.m_refData )
 254     {
 255         m_refData = clone.m_refData;
 256         ++(m_refData->m_count);
 257     }
 258 }
 259
 260 void wxObject::UnRef()
 261 {
 262     if ( m_refData )
 263     {
 264         wxASSERT_MSG( m_refData->m_count > 0, _T("invalid ref data count") );
 265
 266         if ( !--m_refData->m_count )
 267             delete m_refData;
 268         m_refData = NULL;
 269     }
 270 }
 271
 272 void wxObject::AllocExclusive()
 273 {
 274     if ( !m_refData )
 275     {
 276         m_refData = CreateRefData();
 277     }
 278     else if ( m_refData->GetRefCount() > 1 )
 279     {
 280         // note that ref is not going to be destroyed in this case
 281         const wxObjectRefData* ref = m_refData;
 282         UnRef();
 283
 284         // ... so we can still access it
 285         m_refData = CloneRefData(ref);
 286     }
 287     //else: ref count is 1, we are exclusive owners of m_refData anyhow
 288
 289     wxASSERT_MSG( m_refData && m_refData->GetRefCount() == 1,
 290                   _T("wxObject::AllocExclusive() failed.") );
 291 }
 292
 293 wxObjectRefData *wxObject::CreateRefData() const
 294 {
 295     // if you use AllocExclusive() you must override this method
 296     wxFAIL_MSG( _T("CreateRefData() must be overridden if called!") );
 297
 298     return NULL;
 299 }
 300
 301 wxObjectRefData *
 302 wxObject::CloneRefData(const wxObjectRefData * WXUNUSED(data)) const
 303 {
 304     // if you use AllocExclusive() you must override this method
 305     wxFAIL_MSG( _T("CloneRefData() must be overridden if called!") );
 306
 307     return NULL;
 308 }
 309
 310 // ----------------------------------------------------------------------------
 311 // misc
 312 // ----------------------------------------------------------------------------
 313
 314 #if defined(__DARWIN__) && defined(DYLIB_INIT)
 315
 316 extern "C" {
 317     void __initialize_Cplusplus(void);
 318     void wxWindowsDylibInit(void);
 319 };
 320
 321     // Dynamic shared library (dylib) initialization routine
 322     //   required to initialize static C++ objects bacause of lazy dynamic linking
 323     //   http://developer.apple.com/techpubs/macosx/Essentials/
 324     //          SystemOverview/Frameworks/Dynamic_Shared_Libraries.html
 325
 326 void wxWindowsDylibInit()
 327 {
 328     // The function __initialize_Cplusplus() must be called from the shared
 329     // library initialization routine to cause the static C++ objects in
 330     // the library to be initialized (reference number 2441683).
 331
 332     __initialize_Cplusplus();
 333 }
 334
 335 #endif
 336
 337 // vi:sts=4:sw=4:et