]>
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_
20 Codewarrior doesn't define any Windows symbols until some headers
26 # if !defined(__WXMAC__) && !defined(__WINDOWS__) && !defined(WIN32) && !defined(_WIN32_WCE)
27 # define __PALMOS__ 0x05000000
31 #ifdef __WXMAC_XCODE__
33 # include <TargetConditionals.h>
34 # include <AvailabilityMacros.h>
35 # include "wx/osx/config_xcode.h"
45 first define Windows symbols if they're not defined on the command line: we
46 can autodetect everything we need if _WIN32 is defined
48 #if defined(__CYGWIN__) && defined(__WINDOWS__)
54 #if defined(__PALMOS__)
55 # if __PALMOS__ == 0x06000000
56 # define __WXPALMOS6__ 1
58 # if __PALMOS__ == 0x05000000
59 # define __WXPALMOS5__ 1
62 # define __WXPALMOS__ 1
84 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
85 Windows or to test for !__WIN16__, so we must define _WIN32 for
86 Win64 as well to ensure that the existing code continues to work.
93 # endif /* !__WIN64__ */
96 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
97 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
103 #if defined(__WXMSW__)
104 # if !defined(__WINDOWS__)
119 #endif /* __WXMSW__ */
121 /* detect MS SmartPhone */
122 #if defined( WIN32_PLATFORM_WFSP )
123 # ifndef __SMARTPHONE__
124 # define __SMARTPHONE__
131 /* detect PocketPC */
132 #if defined( WIN32_PLATFORM_PSPC )
133 # ifndef __POCKETPC__
134 # define __POCKETPC__
141 /* detect Standard WinCE SDK */
142 #if defined( WCE_PLATFORM_STANDARDSDK )
143 # ifndef __WINCE_STANDARDSDK__
144 # define __WINCE_STANDARDSDK__
151 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
152 # if (_WIN32_WCE >= 400)
153 # ifndef __WINCE_NET__
154 # define __WINCE_NET__
156 # elif (_WIN32_WCE >= 200)
157 # ifndef __HANDHELDPC__
158 # define __HANDHELDPC__
166 #if defined(__WXWINCE__) && defined(_MSC_VER) && (_MSC_VER == 1201)
170 #if defined(__POCKETPC__) || defined(__SMARTPHONE__) || defined(__WXGPE__)
171 # define __WXHANDHELD__
175 Include wx/setup.h for the Unix platform defines generated by configure and
176 the library compilation options
178 Note that it must be included before defining hardware symbols below as they
179 could be already defined by configure
181 #include "wx/setup.h"
185 we're using gccxml to create an XML representation of the entire
186 wxWidgets interface; use a special setup_gccxml.h file to fix some
187 of the stuff #defined by the real setup.h
189 #include "wx/setup_gccxml.h"
193 Convenience for any optional classes that use the wxAnyButton base class.
195 #if wxUSE_TOGGLEBTN || wxUSE_BUTTON
196 #define wxHAS_ANY_BUTTON
201 Hardware platform detection.
203 VC++ defines _M_xxx symbols.
205 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
217 #if defined(_M_MPPC) || defined(__PPC__) || defined(__ppc__)
223 #if defined(_M_ALPHA) || defined(__AXP__)
231 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
232 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
233 the system headers so bring these settings in sync
236 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
237 #if defined(_UNICODE) || defined(UNICODE)
238 # undef wxUSE_UNICODE
239 # define wxUSE_UNICODE 1
241 # ifndef wxUSE_UNICODE
242 # define wxUSE_UNICODE 0
244 #endif /* UNICODE/!UNICODE */
246 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
254 #endif /* wxUSE_UNICODE */
256 #if defined( __MWERKS__ ) && !defined(__INTEL__)
257 /* otherwise MSL headers bring in WIN32 dependant APIs */
263 test for old versions of Borland C, normally need at least 5.82, Turbo
264 explorer, available for free at http://www.turboexplorer.com/downloads
269 Older versions of Borland C have some compiler bugs that need
270 workarounds. Mostly pertains to the free command line compiler 5.5.1.
272 #if defined(__BORLANDC__) && (__BORLANDC__ <= 0x551)
274 The Borland free compiler is unable to handle overloaded enum
275 comparisons under certain conditions e.g. when any class has a
276 conversion ctor for an integral type and there's an overload to
277 compare between an integral type and that class type.
279 # define wxCOMPILER_NO_OVERLOAD_ON_ENUM
282 This is needed to overcome bugs in 5.5.1 STL, linking errors will
283 result if it is not defined.
285 # define _RWSTD_COMPILE_INSTANTIATE
288 Preprocessor in older Borland compilers have major problems
289 concatenating with ##. Specifically, if the string operands being
290 concatenated have special meaning (e.g. L"str", 123i64 etc)
291 then ## will not concatenate the operands correctly.
293 As a workaround, define wxPREPEND* and wxAPPEND* without using
296 # define wxCOMPILER_BROKEN_CONCAT_OPER
297 #endif /* __BORLANDC__ */
300 Define Watcom-specific macros.
303 # define wxWATCOM_VERSION(major,minor) 0
304 # define wxCHECK_WATCOM_VERSION(major,minor) 0
305 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) 0
306 # define WX_WATCOM_ONLY_CODE( x )
308 # if __WATCOMC__ < 1200
309 # error "Only Open Watcom is supported in this release"
312 # define wxWATCOM_VERSION(major,minor) ( major * 100 + minor * 10 + 1100 )
313 # define wxCHECK_WATCOM_VERSION(major,minor) ( __WATCOMC__ >= wxWATCOM_VERSION(major,minor) )
314 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) ( __WATCOMC__ < wxWATCOM_VERSION(major,minor) )
315 # define WX_WATCOM_ONLY_CODE( x ) x
319 OS: first of all, test for MS-DOS platform. We must do this before testing
320 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
322 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
326 /* size_t is the same as unsigned int for Watcom 11 compiler, */
327 /* so define it if it hadn't been done by configure yet */
328 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
330 # define wxSIZE_T_IS_UINT
333 # define wxSIZE_T_IS_ULONG
338 OS: then test for generic Unix defines, then for particular flavours and
339 finally for Unix-like systems
340 Mac OS X matches this case (__MACH__), prior Mac OS do not.
342 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
343 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
344 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
345 defined(__EMX__) || defined(__VMS) || defined(__BEOS__) || defined(__MACH__)
347 # define __UNIX_LIKE__
349 /* Helps SGI compilation, apparently */
352 # define __need_wchar_t
355 Note I use the term __SGI_CC__ for both cc and CC, its not a good
356 idea to mix gcc and cc/CC, the name mangling is different
359 # endif /* gcc/!gcc */
361 /* system headers use this symbol and not __cplusplus in some places */
362 # ifndef _LANGUAGE_C_PLUS_PLUS
363 # define _LANGUAGE_C_PLUS_PLUS
367 # if defined(__SUNPRO_CC)
369 # define __SUNCC__ __SUNPRO_CC
374 # define OS2EMX_PLAIN_CHAR
376 # if defined(__INNOTEK_LIBC__)
377 /* Ensure visibility of strnlen declaration */
381 /* define __HPUX__ for HP-UX where standard macro is __hpux */
382 # if defined(__hpux) && !defined(__HPUX__)
386 # if defined(__CYGWIN__) || defined(__WINE__)
387 # if !defined(wxSIZE_T_IS_UINT)
388 # define wxSIZE_T_IS_UINT
392 /* All of these should already be defined by including configure-
393 generated setup.h but we wish to support Xcode compilation without
394 requiring the user to define these himself.
396 # if defined(__APPLE__) && defined(__MACH__)
403 /* __DARWIN__ is our own define to mean OS X or pure Darwin */
405 # define __DARWIN__ 1
407 /* NOTE: TARGET_CARBON is actually a 0/1 and must be 1 for OS X */
408 # ifndef TARGET_CARBON
409 # define TARGET_CARBON 1
411 /* OS X uses unsigned long size_t for both ILP32 and LP64 modes. */
412 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
413 # define wxSIZE_T_IS_ULONG
420 #elif defined(applec) || \
421 defined(THINK_C) || \
422 (defined(__MWERKS__) && !defined(__INTEL__))
424 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
425 # define wxSIZE_T_IS_ULONG
431 #elif defined(__OS2__)
433 /* wxOS2 vs. non wxOS2 ports on OS2 platform */
434 # if !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
440 # if defined(__IBMCPP__)
441 # define __VISAGEAVER__ __IBMCPP__
444 /* Place other OS/2 compiler environment defines here */
445 # if defined(__VISAGECPP__)
446 /* VisualAge is the only thing that understands _Optlink */
447 # define LINKAGEMODE _Optlink
449 # define wxSIZE_T_IS_UINT
454 #elif defined(__PALMOS__)
456 # error "__WIN32__ should not be defined for PalmOS"
459 # error "__WINDOWS__ should not be defined for PalmOS"
462 # error "__WXMSW__ should not be defined for PalmOS"
466 OS: Otherwise it must be Windows
471 # endif /* Windows */
473 /* to be changed for Win64! */
475 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
479 define another standard symbol for Microsoft Visual C++: the standard
480 one (_MSC_VER) is also defined by Metrowerks compiler
482 # if defined(_MSC_VER) && !defined(__MWERKS__)
483 # define __VISUALC__ _MSC_VER
486 define special symbols for different VC version instead of writing tests
487 for magic numbers such as 1200, 1300 &c repeatedly
489 # if __VISUALC__ < 1100
490 # error "This Visual C++ version is too old and not supported any longer."
491 # elif __VISUALC__ < 1200
492 # define __VISUALC5__
493 # elif __VISUALC__ < 1300
494 # define __VISUALC6__
495 # elif __VISUALC__ < 1400
496 # define __VISUALC7__
497 # elif __VISUALC__ < 1500
498 # define __VISUALC8__
499 # elif __VISUALC__ < 1600
500 # define __VISUALC9__
501 # elif __VISUALC__ < 1700
502 # define __VISUALC10__
504 # pragma message("Please update wx/platform.h to recognize this VC++ version")
507 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
508 # define __BORLANDC__
509 # elif defined(__WATCOMC__)
510 # elif defined(__SC__)
511 # define __SYMANTECC__
512 # endif /* compiler */
514 /* size_t is the same as unsigned int for all Windows compilers we know, */
515 /* so define it if it hadn't been done by configure yet */
516 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG) && !defined(__WIN64__)
517 # define wxSIZE_T_IS_UINT
522 if we're on a Unix system but didn't use configure (so that setup.h didn't
523 define __UNIX__), do define __UNIX__ now
525 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
529 #if defined(__WXMOTIF__) || defined(__WXX11__)
535 # define __DIGITALMARS__
537 # define __SYMANTEC__
541 #ifdef __INTEL_COMPILER
546 We get "Large Files (ILP32) not supported in strict ANSI mode." #error
547 from HP-UX standard headers when compiling with g++ without this:
549 #if defined(__HPUX__) && !defined(__STDC_EXT__)
550 # define __STDC_EXT__ 1
553 /* Force linking against required libraries under Windows: */
555 # include "wx/msw/wince/libraries.h"
556 #elif defined __WINDOWS__
557 # include "wx/msw/libraries.h"
561 This macro can be used to test the gcc version and can be used like this:
563 # if wxCHECK_GCC_VERSION(3, 1)
564 ... we have gcc 3.1 or later ...
566 ... no gcc at all or gcc < 3.1 ...
569 #if defined(__GNUC__) && defined(__GNUC_MINOR__)
570 #define wxCHECK_GCC_VERSION( major, minor ) \
571 ( ( __GNUC__ > (major) ) \
572 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) )
574 #define wxCHECK_GCC_VERSION( major, minor ) 0
577 #if defined(__BORLANDC__) || (defined(__GNUC__) && __GNUC__ < 3)
578 #define wxNEEDS_CHARPP
582 This macro can be used to test the Visual C++ version.
585 # define wxVISUALC_VERSION(major) 0
586 # define wxCHECK_VISUALC_VERSION(major) 0
588 # define wxVISUALC_VERSION(major) ( (6 + major) * 100 )
589 # define wxCHECK_VISUALC_VERSION(major) ( __VISUALC__ >= wxVISUALC_VERSION(major) )
593 This macro can be used to check that the version of mingw32 compiler is
596 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
597 ( defined( __CYGWIN__ ) && defined( __WINDOWS__ ) ) || \
598 wxCHECK_WATCOM_VERSION(1,0) ) && \
599 !defined(__DOS__) && \
600 !defined(__WXPM__) && \
601 !defined(__WXMOTIF__) && \
602 !defined(__WXGTK__) && \
603 !defined(__WXX11__) && \
604 !defined(__WXPALMOS__)
605 # include "wx/msw/gccpriv.h"
607 # undef wxCHECK_W32API_VERSION
608 # define wxCHECK_W32API_VERSION(maj, min) (0)
609 # undef wxCHECK_MINGW32_VERSION
610 # define wxCHECK_MINGW32_VERSION(maj, min) (0)
614 This is similar to wxCHECK_GCC_VERSION but for Sun CC compiler.
618 __SUNCC__ is 0xVRP where V is major version, R release and P patch level
620 #define wxCHECK_SUNCC_VERSION(maj, min) (__SUNCC__ >= (((maj)<<8) | ((min)<<4)))
622 #define wxCHECK_SUNCC_VERSION(maj, min) (0)
626 Handle Darwin gcc universal compilation. Don't do this in an Apple-
627 specific case since no sane compiler should be defining either
628 __BIG_ENDIAN__ or __LITTLE_ENDIAN__ unless it really is generating
629 code that will be hosted on a machine with the appropriate endianness.
630 If a compiler defines neither, assume the user or configure set
631 WORDS_BIGENDIAN appropriately.
633 #if defined(__BIG_ENDIAN__)
634 # undef WORDS_BIGENDIAN
635 # define WORDS_BIGENDIAN 1
636 #elif defined(__LITTLE_ENDIAN__)
637 # undef WORDS_BIGENDIAN
638 #elif defined(__WXMAC__) && !defined(WORDS_BIGENDIAN)
639 /* According to Stefan even ancient Mac compilers defined __BIG_ENDIAN__ */
640 # warning "Compiling wxMac with probably wrong endianness"
642 /* also the 32/64 bit universal builds must be handled accordingly */
645 # undef SIZEOF_VOID_P
647 # undef SIZEOF_SIZE_T
648 # define SIZEOF_VOID_P 8
649 # define SIZEOF_LONG 8
650 # define SIZEOF_SIZE_T 8
652 # undef SIZEOF_VOID_P
654 # undef SIZEOF_SIZE_T
655 # define SIZEOF_VOID_P 4
656 # define SIZEOF_LONG 4
657 # define SIZEOF_SIZE_T 4
662 Define various OS X symbols before including wx/chkconf.h which uses them.
664 __WXOSX_MAC__ means Mac OS X, non embedded
665 __WXOSX_IPHONE__ means OS X iPhone
669 Normally all of __WXOSX_XXX__, __WXOSX__ and __WXMAC__ are defined by
670 configure but ensure that we also define them if configure was not used for
673 The primary symbol remains __WXOSX_XXX__ one, __WXOSX__ exists to allow
674 checking for any OS X port (Carbon and Cocoa) and __WXMAC__ is an old name
677 #if defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__) || defined(__WXOSX_IPHONE__) \
678 || (defined(__DARWIN__) && !wxUSE_GUI)
688 /* setup precise defines according to sdk used */
689 # include <TargetConditionals.h>
690 # if defined(__WXOSX_IPHONE__)
691 # if !( defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE )
692 # error "incorrect SDK for an iPhone build"
695 # if wxUSE_GUI && !(defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__))
696 # error "one of __WXOSX_IPHONE__, __WXOSX_CARBON__ or __WXOSX_COCOA__ must be defined for the GUI build"
698 # if !( defined(TARGET_OS_MAC) && TARGET_OS_MAC )
699 # error "incorrect SDK for a Mac OS X build"
701 # define __WXOSX_MAC__ 1
706 # if defined(__MACH__)
707 # include <AvailabilityMacros.h>
708 # ifndef MAC_OS_X_VERSION_10_4
709 # define MAC_OS_X_VERSION_10_4 1040
711 # ifndef MAC_OS_X_VERSION_10_5
712 # define MAC_OS_X_VERSION_10_5 1050
714 # ifndef MAC_OS_X_VERSION_10_6
715 # define MAC_OS_X_VERSION_10_6 1060
718 # error "only mach-o configurations are supported"
723 __WXOSX_OR_COCOA__ is a common define to wxOSX (Carbon or Cocoa) and wxCocoa ports under OS X.
725 DO NOT use this define in base library code. Although wxMac has its own
726 private base library (and thus __WXOSX_OR_COCOA__,__WXMAC__ and related defines are
727 valid there), wxCocoa shares its library with other ports like wxGTK and wxX11.
729 To keep wx authors from screwing this up, only enable __WXOSX_OR_COCOA__ for wxCocoa when
730 not compiling the base library. We determine this by first checking if
731 wxUSE_BASE is not defined. If it is not defined, then we're not buildling
732 the base library, and possibly not building wx at all (but actually building
733 user code that's using wx). If it is defined then we must check to make sure
734 it is not true. If it is true, we're building base.
736 If you want it in the common darwin base library then use __DARWIN__. You
737 can use any Darwin-available libraries like CoreFoundation but please avoid
738 using OS X libraries like Carbon or CoreServices.
741 #if defined(__WXOSX__) || (defined(__WXCOCOA__) && (!defined(wxUSE_BASE) || !wxUSE_BASE))
742 # define __WXOSX_OR_COCOA__ 1
746 check the consistency of the settings in setup.h: note that this must be
747 done after setting wxUSE_UNICODE correctly as it is used in wx/chkconf.h
748 and after defining the compiler macros which are used in it too
750 #include "wx/chkconf.h"
754 some compilers don't support iostream.h any longer, while some of theme
755 are not updated with <iostream> yet, so override the users setting here
758 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
759 # undef wxUSE_IOSTREAMH
760 # define wxUSE_IOSTREAMH 0
761 #elif defined(__DMC__) || defined(__WATCOMC__)
762 # undef wxUSE_IOSTREAMH
763 # define wxUSE_IOSTREAMH 1
764 #elif defined(__MINGW32__)
765 # undef wxUSE_IOSTREAMH
766 # define wxUSE_IOSTREAMH 0
767 #endif /* compilers with/without iostream.h */
770 old C++ headers (like <iostream.h>) declare classes in the global namespace
771 while the new, standard ones (like <iostream>) do it in std:: namespace,
772 unless it's an old gcc version.
774 using this macro allows constuctions like "wxSTD iostream" to work in
777 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
783 /* On OpenVMS with the most recent HP C++ compiler some function (i.e. wscanf)
784 * are only available in the std-namespace. (BUG???)
786 #if defined( __VMS ) && (__DECCXX_VER >= 70100000) && !defined(__STD_CFRONT) && !defined( __NONAMESPACE_STD )
787 # define wxVMS_USE_STD std::
789 # define wxVMS_USE_STD
793 #define XtDisplay XTDISPLAY
795 #define XtParent XTPARENT
796 #define XtScreen XTSCREEN
797 #define XtWindow XTWINDOW
801 /* Choose which method we will use for updating menus
802 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
803 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
805 #ifndef wxUSE_IDLEMENUUPDATES
806 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
807 # define wxUSE_IDLEMENUUPDATES 0
809 # define wxUSE_IDLEMENUUPDATES 1
814 * Define symbols that are not yet in
815 * configure or possibly some setup.h files.
816 * They will need to be added.
819 #ifndef wxUSE_FILECONFIG
820 # if wxUSE_CONFIG && wxUSE_TEXTFILE
821 # define wxUSE_FILECONFIG 1
823 # define wxUSE_FILECONFIG 0
828 # define wxUSE_HOTKEY 0
831 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
832 # define wxUSE_WXDIB 1
835 #if defined (__WXPALMOS__)
836 #include "wx/palmos/missing.h"
837 #endif /* __WXPALMOS__ */
839 #if !defined (__WXPALMOS5__)
840 #define POSSEC_APPBASE
841 #define POSSEC_ARCHIVE
842 #define POSSEC_CLNTDATA
843 #define POSSEC_CMDLINE
844 #define POSSEC_CONFIG
845 #define POSSEC_DATETIME
846 #define POSSEC_DATETIME2
847 #define POSSEC_DATSTRM
848 #define POSSEC_DIRCMN
849 #define POSSEC_DYNARRAY
850 #define POSSEC_DYNLIB
851 #define POSSEC_DYNLOAD
852 #define POSSEC_ENCCONV
853 #define POSSEC_EXTENDED
856 #define POSSEC_FILECONF
857 #define POSSEC_FILEFN
858 #endif /* __WXPALMOS5__ */
861 Optionally supported C++ features.
865 RTTI: if it is disabled in build/msw/makefile.* then this symbol will
866 already be defined but it's also possible to do it from configure (with
867 g++) or by editing project files with MSVC so test for it here too.
871 Only 4.3 defines __GXX_RTTI by default so its absence is not an
872 indication of disabled RTTI with the previous versions.
874 # if wxCHECK_GCC_VERSION(4, 3)
878 # elif defined(_MSC_VER)
883 #endif /* wxNO_RTTI */
885 #endif /* _WX_PLATFORM_H_ */