include/wx/build.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/build.h
   3 // Purpose:     Runtime build options checking
   4 // Author:      Vadim Zeitlin, Vaclav Slavik
   5 // Modified by:
   6 // Created:     07.05.02
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2002 Vadim Zeitlin <vadim@wxwidgets.org>
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_BUILD_H_
  13 #define _WX_BUILD_H_
  14
  15 #include "wx/version.h"
  16
  17 // NB: This file contains macros for checking binary compatibility of libraries
  18 //     in multilib buildm, plugins and user components.
  19 //     The WX_BUILD_OPTIONS_SIGNATURE macro expands into string that should
  20 //     uniquely identify binary compatible builds: i.e. if two builds of the
  21 //     library are binary compatible, their signature string should be the
  22 //     same; if two builds are binary incompatible, their signatures should
  23 //     be different.
  24 //
  25 //     Therefore, wxUSE_XXX flags that affect binary compatibility (vtables,
  26 //     function signatures) should be accounted for here. So should compilers
  27 //     and compiler versions (but note that binary compatible compiler versions
  28 //     such as gcc-2.95.2 and gcc-2.95.3 should have same signature!).
  29
  30 // ----------------------------------------------------------------------------
  31 // WX_BUILD_OPTIONS_SIGNATURE
  32 // ----------------------------------------------------------------------------
  33
  34 #define __WX_BO_STRINGIZE(x)   __WX_BO_STRINGIZE0(x)
  35 #define __WX_BO_STRINGIZE0(x)  #x
  36
  37 #if (wxMINOR_VERSION % 2) == 0
  38     #define __WX_BO_VERSION(x,y,z) \
  39         __WX_BO_STRINGIZE(x) "." __WX_BO_STRINGIZE(y)
  40 #else
  41     #define __WX_BO_VERSION(x,y,z) \
  42         __WX_BO_STRINGIZE(x) "." __WX_BO_STRINGIZE(y) "." __WX_BO_STRINGIZE(z)
  43 #endif
  44
  45 #ifdef __WXDEBUG__
  46     #define __WX_BO_DEBUG "debug"
  47 #else
  48     #define __WX_BO_DEBUG "no debug"
  49 #endif
  50
  51 #if wxUSE_UNICODE_UTF8
  52     #define __WX_BO_UNICODE "UTF-8"
  53 #elif wxUSE_UNICODE_WCHAR
  54     #define __WX_BO_UNICODE "wchar_t"
  55 #else
  56     #define __WX_BO_UNICODE "ANSI"
  57 #endif
  58
  59 // GCC and Intel C++ share same C++ ABI (and possibly others in the future),
  60 // check if compiler versions are compatible:
  61 #if defined(__GXX_ABI_VERSION)
  62     #define __WX_BO_COMPILER \
  63             ",compiler with C++ ABI " __WX_BO_STRINGIZE(__GXX_ABI_VERSION)
  64 #elif defined(__INTEL_COMPILER)
  65     #define __WX_BO_COMPILER ",Intel C++"
  66 #elif defined(__GNUG__)
  67     #define __WX_BO_COMPILER ",GCC " \
  68             __WX_BO_STRINGIZE(__GNUC__) "." __WX_BO_STRINGIZE(__GNUC_MINOR__)
  69 #elif defined(__VISUALC__)
  70     #define __WX_BO_COMPILER ",Visual C++ " __WX_BO_STRINGIZE(_MSC_VER)
  71 #elif defined(__BORLANDC__)
  72     #define __WX_BO_COMPILER ",Borland C++"
  73 #elif defined(__DIGITALMARS__)
  74     #define __WX_BO_COMPILER ",DigitalMars"
  75 #elif defined(__WATCOMC__)
  76     #define __WX_BO_COMPILER ",Watcom C++"
  77 #else
  78     #define __WX_BO_COMPILER
  79 #endif
  80
  81 // WXWIN_COMPATIBILITY macros affect presence of virtual functions
  82 #if WXWIN_COMPATIBILITY_2_6
  83     #define __WX_BO_WXWIN_COMPAT_2_6 ",compatible with 2.6"
  84 #else
  85     #define __WX_BO_WXWIN_COMPAT_2_6
  86 #endif
  87 #if WXWIN_COMPATIBILITY_2_8
  88     #define __WX_BO_WXWIN_COMPAT_2_8 ",compatible with 2.8"
  89 #else
  90     #define __WX_BO_WXWIN_COMPAT_2_8
  91 #endif
  92
  93 // deriving wxWin containers from STL ones changes them completely:
  94 #if wxUSE_STL
  95     #define __WX_BO_STL ",STL containers"
  96 #else
  97     #define __WX_BO_STL ",wx containers"
  98 #endif
  99
 100 // This macro is passed as argument to wxConsoleApp::CheckBuildOptions()
 101 #define WX_BUILD_OPTIONS_SIGNATURE \
 102     __WX_BO_VERSION(wxMAJOR_VERSION, wxMINOR_VERSION, wxRELEASE_NUMBER) \
 103     " (" __WX_BO_DEBUG "," __WX_BO_UNICODE \
 104      __WX_BO_COMPILER \
 105      __WX_BO_STL \
 106      __WX_BO_WXWIN_COMPAT_2_6 __WX_BO_WXWIN_COMPAT_2_8 \
 107      ")"
 108
 109
 110 // ----------------------------------------------------------------------------
 111 // WX_CHECK_BUILD_OPTIONS
 112 // ----------------------------------------------------------------------------
 113
 114 // Use this macro to check build options. Adding it to a file in DLL will
 115 // ensure that the DLL checks build options in same way IMPLEMENT_APP() does.
 116 #define WX_CHECK_BUILD_OPTIONS(libName)                                 \
 117     static struct wxBuildOptionsChecker                                 \
 118     {                                                                   \
 119         wxBuildOptionsChecker()                                         \
 120         {                                                               \
 121             wxAppConsole::CheckBuildOptions(WX_BUILD_OPTIONS_SIGNATURE, \
 122                                             libName);                   \
 123         }                                                               \
 124     } gs_buildOptionsCheck;
 125
 126
 127 #endif // _WX_BUILD_H_