]>
git.saurik.com Git - wxWidgets.git/blob - include/wx/platform.h
3 * Purpose: define the OS and compiler identification macros
4 * Author: Vadim Zeitlin
6 * Created: 29.10.01 (extracted from wx/defs.h)
8 * Copyright: (c) 1997-2001 Vadim Zeitlin
9 * Licence: wxWindows licence
12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
14 #ifndef _WX_PLATFORM_H_
15 #define _WX_PLATFORM_H_
19 Codewarrior doesn't define any Windows symbols until some headers
25 # if !defined(__WXMAC__) && !defined(__WINDOWS__) && !defined(WIN32) && !defined(_WIN32_WCE)
26 # define __PALMOS__ 0x05000000
30 #ifdef __WXMAC_XCODE__
32 # include <TargetConditionals.h>
33 # include <AvailabilityMacros.h>
34 # include "wx/osx/config_xcode.h"
38 first define Windows symbols if they're not defined on the command line: we
39 can autodetect everything we need if _WIN32 is defined
41 #if defined(__CYGWIN__) && defined(__WINDOWS__)
47 #if defined(__PALMOS__)
48 # if __PALMOS__ == 0x06000000
49 # define __WXPALMOS6__ 1
51 # if __PALMOS__ == 0x05000000
52 # define __WXPALMOS5__ 1
55 # define __WXPALMOS__ 1
77 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
78 Windows or to test for !__WIN16__, so we must define _WIN32 for
79 Win64 as well to ensure that the existing code continues to work.
86 # endif /* !__WIN64__ */
89 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
90 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
96 #if defined(__WXMSW__)
97 # if !defined(__WINDOWS__)
112 #endif /* __WXMSW__ */
114 /* detect MS SmartPhone */
115 #if defined( WIN32_PLATFORM_WFSP )
116 # ifndef __SMARTPHONE__
117 # define __SMARTPHONE__
124 /* detect PocketPC */
125 #if defined( WIN32_PLATFORM_PSPC )
126 # ifndef __POCKETPC__
127 # define __POCKETPC__
134 /* detect Standard WinCE SDK */
135 #if defined( WCE_PLATFORM_STANDARDSDK )
136 # ifndef __WINCE_STANDARDSDK__
137 # define __WINCE_STANDARDSDK__
144 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
145 # if (_WIN32_WCE >= 400)
146 # ifndef __WINCE_NET__
147 # define __WINCE_NET__
149 # elif (_WIN32_WCE >= 200)
150 # ifndef __HANDHELDPC__
151 # define __HANDHELDPC__
159 #if defined(__WXWINCE__) && defined(_MSC_VER) && (_MSC_VER == 1201)
163 #if defined(__POCKETPC__) || defined(__SMARTPHONE__) || defined(__WXGPE__)
164 # define __WXHANDHELD__
168 Include wx/setup.h for the Unix platform defines generated by configure and
169 the library compilation options
171 Note that it must be included before defining hardware symbols below as they
172 could be already defined by configure
174 #include "wx/setup.h"
178 we're using gccxml to create an XML representation of the entire
179 wxWidgets interface; use a special setup_gccxml.h file to fix some
180 of the stuff #defined by the real setup.h
182 #include "wx/setup_gccxml.h"
186 Convenience for any optional classes that use the wxAnyButton base class.
188 #if wxUSE_TOGGLEBTN || wxUSE_BUTTON
189 #define wxHAS_ANY_BUTTON
194 Hardware platform detection.
196 VC++ defines _M_xxx symbols.
198 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
210 #if defined(_M_MPPC) || defined(__PPC__) || defined(__ppc__)
216 #if defined(_M_ALPHA) || defined(__AXP__)
224 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
225 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
226 the system headers so bring these settings in sync
229 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
230 #if defined(_UNICODE) || defined(UNICODE)
231 # undef wxUSE_UNICODE
232 # define wxUSE_UNICODE 1
234 # ifndef wxUSE_UNICODE
235 # define wxUSE_UNICODE 0
237 #endif /* UNICODE/!UNICODE */
239 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
247 #endif /* wxUSE_UNICODE */
249 #if defined( __MWERKS__ ) && !defined(__INTEL__)
250 /* otherwise MSL headers bring in WIN32 dependant APIs */
256 test for old versions of Borland C, normally need at least 5.82, Turbo
257 explorer, available for free at http://www.turboexplorer.com/downloads
262 Older versions of Borland C have some compiler bugs that need
263 workarounds. Mostly pertains to the free command line compiler 5.5.1.
265 #if defined(__BORLANDC__) && (__BORLANDC__ <= 0x551)
267 The Borland free compiler is unable to handle overloaded enum
268 comparisons under certain conditions e.g. when any class has a
269 conversion ctor for an integral type and there's an overload to
270 compare between an integral type and that class type.
272 # define wxCOMPILER_NO_OVERLOAD_ON_ENUM
275 This is needed to overcome bugs in 5.5.1 STL, linking errors will
276 result if it is not defined.
278 # define _RWSTD_COMPILE_INSTANTIATE
281 Preprocessor in older Borland compilers have major problems
282 concatenating with ##. Specifically, if the string operands being
283 concatenated have special meaning (e.g. L"str", 123i64 etc)
284 then ## will not concatenate the operands correctly.
286 As a workaround, define wxPREPEND* and wxAPPEND* without using
289 # define wxCOMPILER_BROKEN_CONCAT_OPER
290 #endif /* __BORLANDC__ */
293 Define Watcom-specific macros.
296 # define wxWATCOM_VERSION(major,minor) 0
297 # define wxCHECK_WATCOM_VERSION(major,minor) 0
298 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) 0
299 # define WX_WATCOM_ONLY_CODE( x )
301 # if __WATCOMC__ < 1200
302 # error "Only Open Watcom is supported in this release"
305 # define wxWATCOM_VERSION(major,minor) ( major * 100 + minor * 10 + 1100 )
306 # define wxCHECK_WATCOM_VERSION(major,minor) ( __WATCOMC__ >= wxWATCOM_VERSION(major,minor) )
307 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) ( __WATCOMC__ < wxWATCOM_VERSION(major,minor) )
308 # define WX_WATCOM_ONLY_CODE( x ) x
312 OS: first of all, test for MS-DOS platform. We must do this before testing
313 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
315 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
319 /* size_t is the same as unsigned int for Watcom 11 compiler, */
320 /* so define it if it hadn't been done by configure yet */
321 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
323 # define wxSIZE_T_IS_UINT
326 # define wxSIZE_T_IS_ULONG
331 OS: then test for generic Unix defines, then for particular flavours and
332 finally for Unix-like systems
333 Mac OS X matches this case (__MACH__), prior Mac OS do not.
335 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
336 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
337 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
338 defined(__EMX__) || defined(__VMS) || defined(__BEOS__) || defined(__MACH__)
340 # define __UNIX_LIKE__
342 /* Helps SGI compilation, apparently */
345 # define __need_wchar_t
348 Note I use the term __SGI_CC__ for both cc and CC, its not a good
349 idea to mix gcc and cc/CC, the name mangling is different
352 # endif /* gcc/!gcc */
354 /* system headers use this symbol and not __cplusplus in some places */
355 # ifndef _LANGUAGE_C_PLUS_PLUS
356 # define _LANGUAGE_C_PLUS_PLUS
360 # if defined(__SUNPRO_CC)
362 # define __SUNCC__ __SUNPRO_CC
367 # define OS2EMX_PLAIN_CHAR
369 # if defined(__INNOTEK_LIBC__)
370 /* Ensure visibility of strnlen declaration */
374 /* define __HPUX__ for HP-UX where standard macro is __hpux */
375 # if defined(__hpux) && !defined(__HPUX__)
379 # if defined(__CYGWIN__) || defined(__WINE__)
380 # if !defined(wxSIZE_T_IS_UINT)
381 # define wxSIZE_T_IS_UINT
385 /* All of these should already be defined by including configure-
386 generated setup.h but we wish to support Xcode compilation without
387 requiring the user to define these himself.
389 # if defined(__APPLE__) && defined(__MACH__)
396 /* __DARWIN__ is our own define to mean OS X or pure Darwin */
398 # define __DARWIN__ 1
400 /* NOTE: TARGET_CARBON is actually a 0/1 and must be 1 for OS X */
401 # ifndef TARGET_CARBON
402 # define TARGET_CARBON 1
404 /* OS X uses unsigned long size_t for both ILP32 and LP64 modes. */
405 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
406 # define wxSIZE_T_IS_ULONG
413 #elif defined(applec) || \
414 defined(THINK_C) || \
415 (defined(__MWERKS__) && !defined(__INTEL__))
417 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
418 # define wxSIZE_T_IS_ULONG
424 #elif defined(__OS2__)
426 /* wxOS2 vs. non wxOS2 ports on OS2 platform */
427 # if !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
433 # if defined(__IBMCPP__)
434 # define __VISAGEAVER__ __IBMCPP__
437 /* Place other OS/2 compiler environment defines here */
438 # if defined(__VISAGECPP__)
439 /* VisualAge is the only thing that understands _Optlink */
440 # define LINKAGEMODE _Optlink
442 # define wxSIZE_T_IS_UINT
447 #elif defined(__PALMOS__)
449 # error "__WIN32__ should not be defined for PalmOS"
452 # error "__WINDOWS__ should not be defined for PalmOS"
455 # error "__WXMSW__ should not be defined for PalmOS"
459 OS: Otherwise it must be Windows
464 # endif /* Windows */
466 /* to be changed for Win64! */
468 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
472 define another standard symbol for Microsoft Visual C++: the standard
473 one (_MSC_VER) is also defined by Metrowerks compiler
475 # if defined(_MSC_VER) && !defined(__MWERKS__)
476 # define __VISUALC__ _MSC_VER
479 define special symbols for different VC version instead of writing tests
480 for magic numbers such as 1200, 1300 &c repeatedly
482 # if __VISUALC__ < 1100
483 # error "This Visual C++ version is too old and not supported any longer."
484 # elif __VISUALC__ < 1200
485 # define __VISUALC5__
486 # elif __VISUALC__ < 1300
487 # define __VISUALC6__
488 # elif __VISUALC__ < 1400
489 # define __VISUALC7__
490 # elif __VISUALC__ < 1500
491 # define __VISUALC8__
492 # elif __VISUALC__ < 1600
493 # define __VISUALC9__
494 # elif __VISUALC__ < 1700
495 # define __VISUALC10__
497 # pragma message("Please update wx/platform.h to recognize this VC++ version")
500 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
501 # define __BORLANDC__
502 # elif defined(__WATCOMC__)
503 # elif defined(__SC__)
504 # define __SYMANTECC__
505 # endif /* compiler */
507 /* size_t is the same as unsigned int for all Windows compilers we know, */
508 /* so define it if it hadn't been done by configure yet */
509 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG) && !defined(__WIN64__)
510 # define wxSIZE_T_IS_UINT
515 if we're on a Unix system but didn't use configure (so that setup.h didn't
516 define __UNIX__), do define __UNIX__ now
518 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
522 #if defined(__WXMOTIF__) || defined(__WXX11__)
528 # define __DIGITALMARS__
530 # define __SYMANTEC__
534 #ifdef __INTEL_COMPILER
539 We get "Large Files (ILP32) not supported in strict ANSI mode." #error
540 from HP-UX standard headers when compiling with g++ without this:
542 #if defined(__HPUX__) && !defined(__STDC_EXT__)
543 # define __STDC_EXT__ 1
546 /* Force linking against required libraries under Windows: */
548 # include "wx/msw/wince/libraries.h"
549 #elif defined __WINDOWS__
550 # include "wx/msw/libraries.h"
554 This macro can be used to test the gcc version and can be used like this:
556 # if wxCHECK_GCC_VERSION(3, 1)
557 ... we have gcc 3.1 or later ...
559 ... no gcc at all or gcc < 3.1 ...
562 #if defined(__GNUC__) && defined(__GNUC_MINOR__)
563 #define wxCHECK_GCC_VERSION( major, minor ) \
564 ( ( __GNUC__ > (major) ) \
565 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) )
567 #define wxCHECK_GCC_VERSION( major, minor ) 0
570 #if defined(__BORLANDC__) || (defined(__GNUC__) && __GNUC__ < 3)
571 #define wxNEEDS_CHARPP
575 This macro can be used to test the Visual C++ version.
578 # define wxVISUALC_VERSION(major) 0
579 # define wxCHECK_VISUALC_VERSION(major) 0
581 # define wxVISUALC_VERSION(major) ( (6 + major) * 100 )
582 # define wxCHECK_VISUALC_VERSION(major) ( __VISUALC__ >= wxVISUALC_VERSION(major) )
586 This macro can be used to check that the version of mingw32 compiler is
589 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
590 ( defined( __CYGWIN__ ) && defined( __WINDOWS__ ) ) || \
591 wxCHECK_WATCOM_VERSION(1,0) ) && \
592 !defined(__DOS__) && \
593 !defined(__WXPM__) && \
594 !defined(__WXMOTIF__) && \
595 !defined(__WXGTK__) && \
596 !defined(__WXX11__) && \
597 !defined(__WXPALMOS__)
598 # include "wx/msw/gccpriv.h"
600 # undef wxCHECK_W32API_VERSION
601 # define wxCHECK_W32API_VERSION(maj, min) (0)
602 # undef wxCHECK_MINGW32_VERSION
603 # define wxCHECK_MINGW32_VERSION(maj, min) (0)
607 This is similar to wxCHECK_GCC_VERSION but for Sun CC compiler.
611 __SUNCC__ is 0xVRP where V is major version, R release and P patch level
613 #define wxCHECK_SUNCC_VERSION(maj, min) (__SUNCC__ >= (((maj)<<8) | ((min)<<4)))
615 #define wxCHECK_SUNCC_VERSION(maj, min) (0)
619 Handle Darwin gcc universal compilation. Don't do this in an Apple-
620 specific case since no sane compiler should be defining either
621 __BIG_ENDIAN__ or __LITTLE_ENDIAN__ unless it really is generating
622 code that will be hosted on a machine with the appropriate endianness.
623 If a compiler defines neither, assume the user or configure set
624 WORDS_BIGENDIAN appropriately.
626 #if defined(__BIG_ENDIAN__)
627 # undef WORDS_BIGENDIAN
628 # define WORDS_BIGENDIAN 1
629 #elif defined(__LITTLE_ENDIAN__)
630 # undef WORDS_BIGENDIAN
631 #elif defined(__WXMAC__) && !defined(WORDS_BIGENDIAN)
632 /* According to Stefan even ancient Mac compilers defined __BIG_ENDIAN__ */
633 # warning "Compiling wxMac with probably wrong endianness"
635 /* also the 32/64 bit universal builds must be handled accordingly */
638 # undef SIZEOF_VOID_P
640 # undef SIZEOF_SIZE_T
641 # define SIZEOF_VOID_P 8
642 # define SIZEOF_LONG 8
643 # define SIZEOF_SIZE_T 8
645 # undef SIZEOF_VOID_P
647 # undef SIZEOF_SIZE_T
648 # define SIZEOF_VOID_P 4
649 # define SIZEOF_LONG 4
650 # define SIZEOF_SIZE_T 4
655 Define various OS X symbols before including wx/chkconf.h which uses them.
657 __WXOSX_MAC__ means Mac OS X, non embedded
658 __WXOSX_IPHONE__ means OS X iPhone
662 Normally all of __WXOSX_XXX__, __WXOSX__ and __WXMAC__ are defined by
663 configure but ensure that we also define them if configure was not used for
666 The primary symbol remains __WXOSX_XXX__ one, __WXOSX__ exists to allow
667 checking for any OS X port (Carbon and Cocoa) and __WXMAC__ is an old name
670 #if defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__) || defined(__WXOSX_IPHONE__) \
671 || (defined(__DARWIN__) && !wxUSE_GUI)
681 /* setup precise defines according to sdk used */
682 # include <TargetConditionals.h>
683 # if defined(__WXOSX_IPHONE__)
684 # if !( defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE )
685 # error "incorrect SDK for an iPhone build"
688 # if wxUSE_GUI && !(defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__))
689 # error "one of __WXOSX_IPHONE__, __WXOSX_CARBON__ or __WXOSX_COCOA__ must be defined for the GUI build"
691 # if !( defined(TARGET_OS_MAC) && TARGET_OS_MAC )
692 # error "incorrect SDK for a Mac OS X build"
694 # define __WXOSX_MAC__ 1
699 # if defined(__MACH__)
700 # include <AvailabilityMacros.h>
701 # ifndef MAC_OS_X_VERSION_10_4
702 # define MAC_OS_X_VERSION_10_4 1040
704 # ifndef MAC_OS_X_VERSION_10_5
705 # define MAC_OS_X_VERSION_10_5 1050
707 # ifndef MAC_OS_X_VERSION_10_6
708 # define MAC_OS_X_VERSION_10_6 1060
711 # error "only mach-o configurations are supported"
716 __WXOSX_OR_COCOA__ is a common define to wxOSX (Carbon or Cocoa) and wxCocoa ports under OS X.
718 DO NOT use this define in base library code. Although wxMac has its own
719 private base library (and thus __WXOSX_OR_COCOA__,__WXMAC__ and related defines are
720 valid there), wxCocoa shares its library with other ports like wxGTK and wxX11.
722 To keep wx authors from screwing this up, only enable __WXOSX_OR_COCOA__ for wxCocoa when
723 not compiling the base library. We determine this by first checking if
724 wxUSE_BASE is not defined. If it is not defined, then we're not buildling
725 the base library, and possibly not building wx at all (but actually building
726 user code that's using wx). If it is defined then we must check to make sure
727 it is not true. If it is true, we're building base.
729 If you want it in the common darwin base library then use __DARWIN__. You
730 can use any Darwin-available libraries like CoreFoundation but please avoid
731 using OS X libraries like Carbon or CoreServices.
734 #if defined(__WXOSX__) || (defined(__WXCOCOA__) && (!defined(wxUSE_BASE) || !wxUSE_BASE))
735 # define __WXOSX_OR_COCOA__ 1
739 check the consistency of the settings in setup.h: note that this must be
740 done after setting wxUSE_UNICODE correctly as it is used in wx/chkconf.h
741 and after defining the compiler macros which are used in it too
743 #include "wx/chkconf.h"
747 some compilers don't support iostream.h any longer, while some of theme
748 are not updated with <iostream> yet, so override the users setting here
751 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
752 # undef wxUSE_IOSTREAMH
753 # define wxUSE_IOSTREAMH 0
754 #elif defined(__DMC__) || defined(__WATCOMC__)
755 # undef wxUSE_IOSTREAMH
756 # define wxUSE_IOSTREAMH 1
757 #elif defined(__MINGW32__)
758 # undef wxUSE_IOSTREAMH
759 # define wxUSE_IOSTREAMH 0
760 #endif /* compilers with/without iostream.h */
763 old C++ headers (like <iostream.h>) declare classes in the global namespace
764 while the new, standard ones (like <iostream>) do it in std:: namespace,
765 unless it's an old gcc version.
767 using this macro allows constuctions like "wxSTD iostream" to work in
770 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
776 /* On OpenVMS with the most recent HP C++ compiler some function (i.e. wscanf)
777 * are only available in the std-namespace. (BUG???)
779 #if defined( __VMS ) && (__DECCXX_VER >= 70100000) && !defined(__STD_CFRONT) && !defined( __NONAMESPACE_STD )
780 # define wxVMS_USE_STD std::
782 # define wxVMS_USE_STD
786 #define XtDisplay XTDISPLAY
788 #define XtParent XTPARENT
789 #define XtScreen XTSCREEN
790 #define XtWindow XTWINDOW
794 /* Choose which method we will use for updating menus
795 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
796 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
798 #ifndef wxUSE_IDLEMENUUPDATES
799 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
800 # define wxUSE_IDLEMENUUPDATES 0
802 # define wxUSE_IDLEMENUUPDATES 1
807 * Define symbols that are not yet in
808 * configure or possibly some setup.h files.
809 * They will need to be added.
812 #ifndef wxUSE_FILECONFIG
813 # if wxUSE_CONFIG && wxUSE_TEXTFILE
814 # define wxUSE_FILECONFIG 1
816 # define wxUSE_FILECONFIG 0
821 # define wxUSE_HOTKEY 0
824 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
825 # define wxUSE_WXDIB 1
828 #if defined (__WXPALMOS__)
829 #include "wx/palmos/missing.h"
830 #endif /* __WXPALMOS__ */
832 #if !defined (__WXPALMOS5__)
833 #define POSSEC_APPBASE
834 #define POSSEC_ARCHIVE
835 #define POSSEC_CLNTDATA
836 #define POSSEC_CMDLINE
837 #define POSSEC_CONFIG
838 #define POSSEC_DATETIME
839 #define POSSEC_DATETIME2
840 #define POSSEC_DATSTRM
841 #define POSSEC_DIRCMN
842 #define POSSEC_DYNARRAY
843 #define POSSEC_DYNLIB
844 #define POSSEC_DYNLOAD
845 #define POSSEC_ENCCONV
846 #define POSSEC_EXTENDED
849 #define POSSEC_FILECONF
850 #define POSSEC_FILEFN
851 #endif /* __WXPALMOS5__ */
854 Optionally supported C++ features.
858 RTTI: if it is disabled in build/msw/makefile.* then this symbol will
859 already be defined but it's also possible to do it from configure (with
860 g++) or by editing project files with MSVC so test for it here too.
864 Only 4.3 defines __GXX_RTTI by default so its absence is not an
865 indication of disabled RTTI with the previous versions.
867 # if wxCHECK_GCC_VERSION(4, 3)
871 # elif defined(_MSC_VER)
876 #endif /* wxNO_RTTI */
878 #endif /* _WX_PLATFORM_H_ */