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
32 __WXOSX_MAC__ means Mac OS X, non embedded
33 __WXOSX_IPHONE__ means OS X iPhone
37 Normally all of __WXOSX_XXX__, __WXOSX__ and __WXMAC__ are defined by
38 configure but ensure that we also define them if configure was not used for
41 The primare symbol remains __WXOSX_XXX__ one, __WXOSX__ exists to allow
42 checking for any OS X port (Carbon and Cocoa) and __WXMAC__ is an old name
45 #if defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__) || defined(__WXOSX_IPHONE__)
55 /* setup precise defines according to sdk used */
56 # include <TargetConditionals.h>
57 # if defined(__WXOSX_IPHONE__)
58 # if !( defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE )
59 # error "incorrect SDK for an iPhone build"
61 # elif defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__)
62 # if !( defined(TARGET_OS_MAC) && TARGET_OS_MAC )
63 # error "incorrect SDK for a Mac OS X build"
65 # define __WXOSX_MAC__ 1
67 # error "one of __WXOSX_IPHONE__, __WXOSX_CARBON__ or __WXOSX_COCOA__ must be defined"
72 # if defined(__MACH__)
73 # include <AvailabilityMacros.h>
74 # ifndef MAC_OS_X_VERSION_10_4
75 # define MAC_OS_X_VERSION_10_4 1040
77 # ifndef MAC_OS_X_VERSION_10_5
78 # define MAC_OS_X_VERSION_10_5 1050
80 # ifndef MAC_OS_X_VERSION_10_6
81 # define MAC_OS_X_VERSION_10_6 1060
84 # error "only mach-o configurations are supported"
89 __WXOSX_OR_COCOA__ is a common define to wxOSX (Carbon or Cocoa) and wxCocoa ports under OS X.
91 DO NOT use this define in base library code. Although wxMac has its own
92 private base library (and thus __WXOSX_OR_COCOA__,__WXMAC__ and related defines are
93 valid there), wxCocoa shares its library with other ports like wxGTK and wxX11.
95 To keep wx authors from screwing this up, only enable __WXOSX_OR_COCOA__ for wxCocoa when
96 not compiling the base library. We determine this by first checking if
97 wxUSE_BASE is not defined. If it is not defined, then we're not buildling
98 the base library, and possibly not building wx at all (but actually building
99 user code that's using wx). If it is defined then we must check to make sure
100 it is not true. If it is true, we're building base.
102 If you want it in the common darwin base library then use __DARWIN__. You
103 can use any Darwin-available libraries like CoreFoundation but please avoid
104 using OS X libraries like Carbon or CoreServices.
107 #if defined(__WXOSX__) || (defined(__WXCOCOA__) && (!defined(wxUSE_BASE) || !wxUSE_BASE))
108 # define __WXOSX_OR_COCOA__ 1
111 #ifdef __WXOSX_OR_COCOA__
112 # ifdef __WXMAC_XCODE__
114 # include <TargetConditionals.h>
115 # include <AvailabilityMacros.h>
116 # include "wx/osx/config_xcode.h"
120 first define Windows symbols if they're not defined on the command line: we
121 can autodetect everything we need if _WIN32 is defined
123 #if defined(__CYGWIN__) && defined(__WINDOWS__)
129 #if defined(__PALMOS__)
130 # if __PALMOS__ == 0x06000000
131 # define __WXPALMOS6__ 1
133 # if __PALMOS__ == 0x05000000
134 # define __WXPALMOS5__ 1
136 # ifndef __WXPALMOS__
137 # define __WXPALMOS__ 1
159 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
160 Windows or to test for !__WIN16__, so we must define _WIN32 for
161 Win64 as well to ensure that the existing code continues to work.
164 # endif /* !_WIN32 */
168 # endif /* !__WIN64__ */
171 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
172 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
178 #if defined(__WXMSW__)
179 # if !defined(__WINDOWS__)
194 #endif /* __WXMSW__ */
196 /* detect MS SmartPhone */
197 #if defined( WIN32_PLATFORM_WFSP )
198 # ifndef __SMARTPHONE__
199 # define __SMARTPHONE__
206 /* detect PocketPC */
207 #if defined( WIN32_PLATFORM_PSPC )
208 # ifndef __POCKETPC__
209 # define __POCKETPC__
216 /* detect Standard WinCE SDK */
217 #if defined( WCE_PLATFORM_STANDARDSDK )
218 # ifndef __WINCE_STANDARDSDK__
219 # define __WINCE_STANDARDSDK__
226 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
227 # if (_WIN32_WCE >= 400)
228 # ifndef __WINCE_NET__
229 # define __WINCE_NET__
231 # elif (_WIN32_WCE >= 200)
232 # ifndef __HANDHELDPC__
233 # define __HANDHELDPC__
241 #if defined(__WXWINCE__) && defined(_MSC_VER) && (_MSC_VER == 1201)
245 #if defined(__POCKETPC__) || defined(__SMARTPHONE__) || defined(__WXGPE__)
246 # define __WXHANDHELD__
250 Include wx/setup.h for the Unix platform defines generated by configure and
251 the library compilation options
253 Note that it must be included before defining hardware symbols below as they
254 could be already defined by configure
256 #include "wx/setup.h"
260 we're using gccxml to create an XML representation of the entire
261 wxWidgets interface; use a special setup_gccxml.h file to fix some
262 of the stuff #defined by the real setup.h
264 #include "wx/setup_gccxml.h"
269 Hardware platform detection.
271 VC++ defines _M_xxx symbols.
273 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
285 #if defined(_M_MPPC) || defined(__PPC__) || defined(__ppc__)
291 #if defined(_M_ALPHA) || defined(__AXP__)
299 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
300 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
301 the system headers so bring these settings in sync
304 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
305 #if defined(_UNICODE) || defined(UNICODE)
306 # undef wxUSE_UNICODE
307 # define wxUSE_UNICODE 1
309 # ifndef wxUSE_UNICODE
310 # define wxUSE_UNICODE 0
312 #endif /* UNICODE/!UNICODE */
314 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
322 #endif /* wxUSE_UNICODE */
324 #if defined( __MWERKS__ ) && !defined(__INTEL__)
325 /* otherwise MSL headers bring in WIN32 dependant APIs */
331 test for old versions of Borland C, normally need at least 5.82, Turbo
332 explorer, available for free at http://www.turboexplorer.com/downloads
337 Older versions of Borland C have some compiler bugs that need
338 workarounds. Mostly pertains to the free command line compiler 5.5.1.
340 #if defined(__BORLANDC__) && (__BORLANDC__ <= 0x551)
342 The Borland free compiler is unable to handle overloaded enum
343 comparisons under certain conditions e.g. when any class has a
344 conversion ctor for an integral type and there's an overload to
345 compare between an integral type and that class type.
347 # define wxCOMPILER_NO_OVERLOAD_ON_ENUM
350 This is needed to overcome bugs in 5.5.1 STL, linking errors will
351 result if it is not defined.
353 # define _RWSTD_COMPILE_INSTANTIATE
356 Preprocessor in older Borland compilers have major problems
357 concatenating with ##. Specifically, if the string operands being
358 concatenated have special meaning (e.g L"str", 123i64 etc)
359 then ## will not concatenate the operands correctly.
361 As a workaround, define wxPREPEND* and wxAPPEND* without using
364 # define wxCOMPILER_BROKEN_CONCAT_OPER
365 #endif /* __BORLANDC__ */
368 Define Watcom-specific macros.
371 # define wxWATCOM_VERSION(major,minor) 0
372 # define wxCHECK_WATCOM_VERSION(major,minor) 0
373 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) 0
374 # define WX_WATCOM_ONLY_CODE( x )
376 # if __WATCOMC__ < 1200
377 # error "Only Open Watcom is supported in this release"
380 # define wxWATCOM_VERSION(major,minor) ( major * 100 + minor * 10 + 1100 )
381 # define wxCHECK_WATCOM_VERSION(major,minor) ( __WATCOMC__ >= wxWATCOM_VERSION(major,minor) )
382 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) ( __WATCOMC__ < wxWATCOM_VERSION(major,minor) )
383 # define WX_WATCOM_ONLY_CODE( x ) x
387 OS: first of all, test for MS-DOS platform. We must do this before testing
388 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
390 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
394 /* size_t is the same as unsigned int for Watcom 11 compiler, */
395 /* so define it if it hadn't been done by configure yet */
396 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
398 # define wxSIZE_T_IS_UINT
401 # define wxSIZE_T_IS_ULONG
406 OS: then test for generic Unix defines, then for particular flavours and
407 finally for Unix-like systems
408 Mac OS X matches this case (__MACH__), prior Mac OS do not.
410 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
411 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
412 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
413 defined(__EMX__) || defined(__VMS) || defined(__BEOS__) || defined(__MACH__)
415 # define __UNIX_LIKE__
417 /* Helps SGI compilation, apparently */
420 # define __need_wchar_t
423 Note I use the term __SGI_CC__ for both cc and CC, its not a good
424 idea to mix gcc and cc/CC, the name mangling is different
427 # endif /* gcc/!gcc */
429 /* system headers use this symbol and not __cplusplus in some places */
430 # ifndef _LANGUAGE_C_PLUS_PLUS
431 # define _LANGUAGE_C_PLUS_PLUS
435 # if defined(__SUNPRO_CC)
437 # define __SUNCC__ __SUNPRO_CC
442 # define OS2EMX_PLAIN_CHAR
444 # if defined(__INNOTEK_LIBC__)
445 /* Ensure visibility of strnlen declaration */
449 /* define __HPUX__ for HP-UX where standard macro is __hpux */
450 # if defined(__hpux) && !defined(__HPUX__)
454 # if defined(__CYGWIN__) || defined(__WINE__)
455 # if !defined(wxSIZE_T_IS_UINT)
456 # define wxSIZE_T_IS_UINT
460 /* All of these should already be defined by including configure-
461 generated setup.h but we wish to support Xcode compilation without
462 requiring the user to define these himself.
464 # if defined(__APPLE__) && defined(__MACH__)
471 /* __DARWIN__ is our own define to mean OS X or pure Darwin */
473 # define __DARWIN__ 1
475 /* NOTE: TARGET_CARBON is actually a 0/1 and must be 1 for OS X */
476 # ifndef TARGET_CARBON
477 # define TARGET_CARBON 1
479 /* OS X uses unsigned long size_t for both ILP32 and LP64 modes. */
480 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
481 # define wxSIZE_T_IS_ULONG
488 #elif defined(applec) || \
489 defined(THINK_C) || \
490 (defined(__MWERKS__) && !defined(__INTEL__))
492 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
493 # define wxSIZE_T_IS_ULONG
499 #elif defined(__OS2__)
501 /* wxOS2 vs. non wxOS2 ports on OS2 platform */
502 # if !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
508 # if defined(__IBMCPP__)
509 # define __VISAGEAVER__ __IBMCPP__
512 /* Place other OS/2 compiler environment defines here */
513 # if defined(__VISAGECPP__)
514 /* VisualAge is the only thing that understands _Optlink */
515 # define LINKAGEMODE _Optlink
517 # define wxSIZE_T_IS_UINT
522 #elif defined(__PALMOS__)
524 # error "__WIN32__ should not be defined for PalmOS"
527 # error "__WINDOWS__ should not be defined for PalmOS"
530 # error "__WXMSW__ should not be defined for PalmOS"
534 OS: Otherwise it must be Windows
539 # endif /* Windows */
541 /* to be changed for Win64! */
543 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
547 define another standard symbol for Microsoft Visual C++: the standard
548 one (_MSC_VER) is also defined by Metrowerks compiler
550 # if defined(_MSC_VER) && !defined(__MWERKS__)
551 # define __VISUALC__ _MSC_VER
554 define special symbols for different VC version instead of writing tests
555 for magic numbers such as 1200, 1300 &c repeatedly
557 # if __VISUALC__ < 1100
558 # error "This Visual C++ version is too old and not supported any longer."
559 # elif __VISUALC__ < 1200
560 # define __VISUALC5__
561 # elif __VISUALC__ < 1300
562 # define __VISUALC6__
563 # elif __VISUALC__ < 1400
564 # define __VISUALC7__
565 # elif __VISUALC__ < 1500
566 # define __VISUALC8__
567 # elif __VISUALC__ < 1600
568 # define __VISUALC9__
569 # elif __VISUALC__ < 1700
570 # define __VISUALC10__
572 # pragma message("Please update wx/platform.h to recognize this VC++ version")
575 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
576 # define __BORLANDC__
577 # elif defined(__WATCOMC__)
578 # elif defined(__SC__)
579 # define __SYMANTECC__
580 # endif /* compiler */
582 /* size_t is the same as unsigned int for all Windows compilers we know, */
583 /* so define it if it hadn't been done by configure yet */
584 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG) && !defined(__WIN64__)
585 # define wxSIZE_T_IS_UINT
590 if we're on a Unix system but didn't use configure (so that setup.h didn't
591 define __UNIX__), do define __UNIX__ now
593 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
597 #if defined(__WXMOTIF__) || defined(__WXX11__)
603 # define __DIGITALMARS__
605 # define __SYMANTEC__
609 #ifdef __INTEL_COMPILER
614 We get "Large Files (ILP32) not supported in strict ANSI mode." #error
615 from HP-UX standard headers when compiling with g++ without this:
617 #if defined(__HPUX__) && !defined(__STDC_EXT__)
618 # define __STDC_EXT__ 1
621 /* Force linking against required libraries under Windows: */
623 # include "wx/msw/wince/libraries.h"
624 #elif defined __WINDOWS__
625 # include "wx/msw/libraries.h"
629 This macro can be used to test the gcc version and can be used like this:
631 # if wxCHECK_GCC_VERSION(3, 1)
632 ... we have gcc 3.1 or later ...
634 ... no gcc at all or gcc < 3.1 ...
637 #if defined(__GNUC__) && defined(__GNUC_MINOR__)
638 #define wxCHECK_GCC_VERSION( major, minor ) \
639 ( ( __GNUC__ > (major) ) \
640 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) )
642 #define wxCHECK_GCC_VERSION( major, minor ) 0
645 #if defined(__BORLANDC__) || (defined(__GNUC__) && __GNUC__ < 3)
646 #define wxNEEDS_CHARPP
650 This macro can be used to test the Visual C++ version.
653 # define wxVISUALC_VERSION(major) 0
654 # define wxCHECK_VISUALC_VERSION(major) 0
656 # define wxVISUALC_VERSION(major) ( (6 + major) * 100 )
657 # define wxCHECK_VISUALC_VERSION(major) ( __VISUALC__ >= wxVISUALC_VERSION(major) )
661 This macro can be used to check that the version of mingw32 compiler is
664 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
665 ( defined( __CYGWIN__ ) && defined( __WINDOWS__ ) ) || \
666 wxCHECK_WATCOM_VERSION(1,0) ) && \
667 !defined(__DOS__) && \
668 !defined(__WXPM__) && \
669 !defined(__WXMOTIF__) && \
670 !defined(__WXGTK__) && \
671 !defined(__WXX11__) && \
672 !defined(__WXPALMOS__)
673 # include "wx/msw/gccpriv.h"
675 # undef wxCHECK_W32API_VERSION
676 # define wxCHECK_W32API_VERSION(maj, min) (0)
677 # undef wxCHECK_MINGW32_VERSION
678 # define wxCHECK_MINGW32_VERSION(maj, min) (0)
682 This is similar to wxCHECK_GCC_VERSION but for Sun CC compiler.
686 __SUNCC__ is 0xVRP where V is major version, R release and P patch level
688 #define wxCHECK_SUNCC_VERSION(maj, min) (__SUNCC__ >= (((maj)<<8) | ((min)<<4)))
690 #define wxCHECK_SUNCC_VERSION(maj, min) (0)
694 Handle Darwin gcc universal compilation. Don't do this in an Apple-
695 specific case since no sane compiler should be defining either
696 __BIG_ENDIAN__ or __LITTLE_ENDIAN__ unless it really is generating
697 code that will be hosted on a machine with the appropriate endianness.
698 If a compiler defines neither, assume the user or configure set
699 WORDS_BIGENDIAN appropriately.
701 #if defined(__BIG_ENDIAN__)
702 # undef WORDS_BIGENDIAN
703 # define WORDS_BIGENDIAN 1
704 #elif defined(__LITTLE_ENDIAN__)
705 # undef WORDS_BIGENDIAN
706 #elif defined(__WXMAC__) && !defined(WORDS_BIGENDIAN)
707 /* According to Stefan even ancient Mac compilers defined __BIG_ENDIAN__ */
708 # warning "Compiling wxMac with probably wrong endianness"
710 /* also the 32/64 bit universal builds must be handled accordingly */
713 # undef SIZEOF_VOID_P
715 # undef SIZEOF_SIZE_T
716 # define SIZEOF_VOID_P 8
717 # define SIZEOF_LONG 8
718 # define SIZEOF_SIZE_T 8
720 # undef SIZEOF_VOID_P
722 # undef SIZEOF_SIZE_T
723 # define SIZEOF_VOID_P 4
724 # define SIZEOF_LONG 4
725 # define SIZEOF_SIZE_T 4
729 check the consistency of the settings in setup.h: note that this must be
730 done after setting wxUSE_UNICODE correctly as it is used in wx/chkconf.h
731 and after defining the compiler macros which are used in it too
733 #include "wx/chkconf.h"
737 some compilers don't support iostream.h any longer, while some of theme
738 are not updated with <iostream> yet, so override the users setting here
741 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
742 # undef wxUSE_IOSTREAMH
743 # define wxUSE_IOSTREAMH 0
744 #elif defined(__DMC__) || defined(__WATCOMC__)
745 # undef wxUSE_IOSTREAMH
746 # define wxUSE_IOSTREAMH 1
747 #elif defined(__MINGW32__)
748 # undef wxUSE_IOSTREAMH
749 # define wxUSE_IOSTREAMH 0
750 #endif /* compilers with/without iostream.h */
753 old C++ headers (like <iostream.h>) declare classes in the global namespace
754 while the new, standard ones (like <iostream>) do it in std:: namespace,
755 unless it's an old gcc version.
757 using this macro allows constuctions like "wxSTD iostream" to work in
760 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
766 /* On OpenVMS with the most recent HP C++ compiler some function (i.e. wscanf)
767 * are only available in the std-namespace. (BUG???)
769 #if defined( __VMS ) && (__DECCXX_VER >= 70100000) && !defined(__STD_CFRONT) && !defined( __NONAMESPACE_STD )
770 # define wxVMS_USE_STD std::
772 # define wxVMS_USE_STD
776 #define XtDisplay XTDISPLAY
778 #define XtParent XTPARENT
779 #define XtScreen XTSCREEN
780 #define XtWindow XTWINDOW
784 /* Choose which method we will use for updating menus
785 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
786 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
788 #ifndef wxUSE_IDLEMENUUPDATES
789 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
790 # define wxUSE_IDLEMENUUPDATES 0
792 # define wxUSE_IDLEMENUUPDATES 1
797 * Define symbols that are not yet in
798 * configure or possibly some setup.h files.
799 * They will need to be added.
802 #ifndef wxUSE_FILECONFIG
803 # if wxUSE_CONFIG && wxUSE_TEXTFILE
804 # define wxUSE_FILECONFIG 1
806 # define wxUSE_FILECONFIG 0
811 # define wxUSE_HOTKEY 0
814 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
815 # define wxUSE_WXDIB 1
819 We need AvailabilityMacros.h for ifdefing out things that don't exist on
821 FIXME: We need a better way to detect for 10.3 then including a system header
824 #include <AvailabilityMacros.h>
827 #if defined (__WXPALMOS__)
828 #include "wx/palmos/missing.h"
829 #endif // __WXPALMOS__
831 #if !defined (__WXPALMOS5__)
832 #define POSSEC_APPBASE
833 #define POSSEC_ARCHIVE
834 #define POSSEC_CLNTDATA
835 #define POSSEC_CMDLINE
836 #define POSSEC_CONFIG
837 #define POSSEC_DATETIME
838 #define POSSEC_DATETIME2
839 #define POSSEC_DATSTRM
840 #define POSSEC_DIRCMN
841 #define POSSEC_DYNARRAY
842 #define POSSEC_DYNLIB
843 #define POSSEC_DYNLOAD
844 #define POSSEC_ENCCONV
845 #define POSSEC_EXTENDED
848 #define POSSEC_FILECONF
849 #define POSSEC_FILEFN
850 #endif // __WXPALMOS5__
853 Optionally supported C++ features.
857 RTTI: if it is disabled in build/msw/makefile.* then this symbol will
858 already be defined but it's also possible to do it from configure (with
859 g++) or by editing project files with MSVC so test for it here too.
863 Only 4.3 defines __GXX_RTTI by default so its absence is not an
864 indication of disabled RTTI with the previous versions.
866 # if wxCHECK_GCC_VERSION(4, 3)
870 # elif defined(_MSC_VER)
877 #endif /* _WX_PLATFORM_H_ */