]>
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
27 #ifdef __WXMAC_XCODE__
29 # include <TargetConditionals.h>
30 # include <AvailabilityMacros.h>
31 # ifndef MAC_OS_X_VERSION_10_4
32 # define MAC_OS_X_VERSION_10_4 1040
34 # ifndef MAC_OS_X_VERSION_10_5
35 # define MAC_OS_X_VERSION_10_5 1050
37 # ifndef MAC_OS_X_VERSION_10_6
38 # define MAC_OS_X_VERSION_10_6 1060
40 # include "wx/osx/config_xcode.h"
50 first define Windows symbols if they're not defined on the command line: we
51 can autodetect everything we need if _WIN32 is defined
53 #if defined(__CYGWIN__) && defined(__WINDOWS__)
62 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
63 Windows or to test for !__WIN16__, so we must define _WIN32 for
64 Win64 as well to ensure that the existing code continues to work.
71 # endif /* !__WIN64__ */
74 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
75 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
81 #if defined(__WXMSW__)
82 # if !defined(__WINDOWS__)
97 #endif /* __WXMSW__ */
99 /* detect MS SmartPhone */
100 #if defined( WIN32_PLATFORM_WFSP )
101 # ifndef __SMARTPHONE__
102 # define __SMARTPHONE__
109 /* detect PocketPC */
110 #if defined( WIN32_PLATFORM_PSPC )
111 # ifndef __POCKETPC__
112 # define __POCKETPC__
119 /* detect Standard WinCE SDK */
120 #if defined( WCE_PLATFORM_STANDARDSDK )
121 # ifndef __WINCE_STANDARDSDK__
122 # define __WINCE_STANDARDSDK__
129 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
130 # if (_WIN32_WCE >= 400)
131 # ifndef __WINCE_NET__
132 # define __WINCE_NET__
134 # elif (_WIN32_WCE >= 200)
135 # ifndef __HANDHELDPC__
136 # define __HANDHELDPC__
144 #if defined(__WXWINCE__) && defined(_MSC_VER) && (_MSC_VER == 1201)
148 #if defined(__POCKETPC__) || defined(__SMARTPHONE__) || defined(__WXGPE__)
149 # define __WXHANDHELD__
153 Include wx/setup.h for the Unix platform defines generated by configure and
154 the library compilation options
156 Note that it must be included before defining hardware symbols below as they
157 could be already defined by configure
159 #include "wx/setup.h"
163 we're using gccxml to create an XML representation of the entire
164 wxWidgets interface; use a special setup_gccxml.h file to fix some
165 of the stuff #defined by the real setup.h
167 #include "wx/setup_gccxml.h"
171 Convenience for any optional classes that use the wxAnyButton base class.
173 #if wxUSE_TOGGLEBTN || wxUSE_BUTTON
174 #define wxHAS_ANY_BUTTON
179 Hardware platform detection.
181 VC++ defines _M_xxx symbols.
183 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
195 #if defined(_M_MPPC) || defined(__PPC__) || defined(__ppc__)
201 #if defined(_M_ALPHA) || defined(__AXP__)
209 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
210 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
211 the system headers so bring these settings in sync
214 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
215 #if defined(_UNICODE) || defined(UNICODE)
216 # undef wxUSE_UNICODE
217 # define wxUSE_UNICODE 1
219 # ifndef wxUSE_UNICODE
220 # define wxUSE_UNICODE 0
222 #endif /* UNICODE/!UNICODE */
224 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
232 #endif /* wxUSE_UNICODE */
234 #if defined( __MWERKS__ ) && !defined(__INTEL__)
235 /* otherwise MSL headers bring in WIN32 dependant APIs */
241 test for old versions of Borland C, normally need at least 5.82, Turbo
242 explorer, available for free at http://www.turboexplorer.com/downloads
247 Older versions of Borland C have some compiler bugs that need
248 workarounds. Mostly pertains to the free command line compiler 5.5.1.
250 #if defined(__BORLANDC__) && (__BORLANDC__ <= 0x551)
252 The Borland free compiler is unable to handle overloaded enum
253 comparisons under certain conditions e.g. when any class has a
254 conversion ctor for an integral type and there's an overload to
255 compare between an integral type and that class type.
257 # define wxCOMPILER_NO_OVERLOAD_ON_ENUM
260 This is needed to overcome bugs in 5.5.1 STL, linking errors will
261 result if it is not defined.
263 # define _RWSTD_COMPILE_INSTANTIATE
266 Preprocessor in older Borland compilers have major problems
267 concatenating with ##. Specifically, if the string operands being
268 concatenated have special meaning (e.g. L"str", 123i64 etc)
269 then ## will not concatenate the operands correctly.
271 As a workaround, define wxPREPEND* and wxAPPEND* without using
274 # define wxCOMPILER_BROKEN_CONCAT_OPER
275 #endif /* __BORLANDC__ */
278 Define Watcom-specific macros.
281 # define wxWATCOM_VERSION(major,minor) 0
282 # define wxCHECK_WATCOM_VERSION(major,minor) 0
283 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) 0
284 # define WX_WATCOM_ONLY_CODE( x )
286 # if __WATCOMC__ < 1200
287 # error "Only Open Watcom is supported in this release"
290 # define wxWATCOM_VERSION(major,minor) ( major * 100 + minor * 10 + 1100 )
291 # define wxCHECK_WATCOM_VERSION(major,minor) ( __WATCOMC__ >= wxWATCOM_VERSION(major,minor) )
292 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) ( __WATCOMC__ < wxWATCOM_VERSION(major,minor) )
293 # define WX_WATCOM_ONLY_CODE( x ) x
297 OS: first of all, test for MS-DOS platform. We must do this before testing
298 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
300 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
304 /* size_t is the same as unsigned int for Watcom 11 compiler, */
305 /* so define it if it hadn't been done by configure yet */
306 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
308 # define wxSIZE_T_IS_UINT
311 # define wxSIZE_T_IS_ULONG
316 OS: then test for generic Unix defines, then for particular flavours and
317 finally for Unix-like systems
318 Mac OS X matches this case (__MACH__), prior Mac OS do not.
320 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
321 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
322 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
323 defined(__EMX__) || defined(__VMS) || defined(__BEOS__) || defined(__MACH__)
325 # define __UNIX_LIKE__
327 /* Helps SGI compilation, apparently */
330 # define __need_wchar_t
333 Note I use the term __SGI_CC__ for both cc and CC, its not a good
334 idea to mix gcc and cc/CC, the name mangling is different
337 # endif /* gcc/!gcc */
339 /* system headers use this symbol and not __cplusplus in some places */
340 # ifndef _LANGUAGE_C_PLUS_PLUS
341 # define _LANGUAGE_C_PLUS_PLUS
345 # if defined(__SUNPRO_CC)
347 # define __SUNCC__ __SUNPRO_CC
352 # define OS2EMX_PLAIN_CHAR
354 # if defined(__INNOTEK_LIBC__)
355 /* Ensure visibility of strnlen declaration */
359 /* define __HPUX__ for HP-UX where standard macro is __hpux */
360 # if defined(__hpux) && !defined(__HPUX__)
364 # if defined(__CYGWIN__) || defined(__WINE__)
365 # if !defined(wxSIZE_T_IS_UINT)
366 # define wxSIZE_T_IS_UINT
370 /* All of these should already be defined by including configure-
371 generated setup.h but we wish to support Xcode compilation without
372 requiring the user to define these himself.
374 # if defined(__APPLE__) && defined(__MACH__)
381 /* __DARWIN__ is our own define to mean OS X or pure Darwin */
383 # define __DARWIN__ 1
385 /* NOTE: TARGET_CARBON is actually a 0/1 and must be 1 for OS X */
386 # ifndef TARGET_CARBON
387 # define TARGET_CARBON 1
389 /* OS X uses unsigned long size_t for both ILP32 and LP64 modes. */
390 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
391 # define wxSIZE_T_IS_ULONG
398 #elif defined(applec) || \
399 defined(THINK_C) || \
400 (defined(__MWERKS__) && !defined(__INTEL__))
402 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
403 # define wxSIZE_T_IS_ULONG
409 #elif defined(__OS2__)
411 /* wxOS2 vs. non wxOS2 ports on OS2 platform */
412 # if !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
418 # if defined(__IBMCPP__)
419 # define __VISAGEAVER__ __IBMCPP__
422 /* Place other OS/2 compiler environment defines here */
423 # if defined(__VISAGECPP__)
424 /* VisualAge is the only thing that understands _Optlink */
425 # define LINKAGEMODE _Optlink
427 # define wxSIZE_T_IS_UINT
430 OS: Otherwise it must be Windows
435 # endif /* Windows */
437 /* to be changed for Win64! */
439 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
443 define another standard symbol for Microsoft Visual C++: the standard
444 one (_MSC_VER) is also defined by Metrowerks compiler
446 # if defined(_MSC_VER) && !defined(__MWERKS__)
447 # define __VISUALC__ _MSC_VER
450 define special symbols for different VC version instead of writing tests
451 for magic numbers such as 1200, 1300 &c repeatedly
453 # if __VISUALC__ < 1100
454 # error "This Visual C++ version is too old and not supported any longer."
455 # elif __VISUALC__ < 1200
456 # define __VISUALC5__
457 # elif __VISUALC__ < 1300
458 # define __VISUALC6__
459 # elif __VISUALC__ < 1400
460 # define __VISUALC7__
461 # elif __VISUALC__ < 1500
462 # define __VISUALC8__
463 # elif __VISUALC__ < 1600
464 # define __VISUALC9__
465 # elif __VISUALC__ < 1700
466 # define __VISUALC10__
468 # pragma message("Please update wx/platform.h to recognize this VC++ version")
471 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
472 # define __BORLANDC__
473 # elif defined(__WATCOMC__)
474 # elif defined(__SC__)
475 # define __SYMANTECC__
476 # endif /* compiler */
478 /* size_t is the same as unsigned int for all Windows compilers we know, */
479 /* so define it if it hadn't been done by configure yet */
480 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG) && !defined(__WIN64__)
481 # define wxSIZE_T_IS_UINT
486 if we're on a Unix system but didn't use configure (so that setup.h didn't
487 define __UNIX__), do define __UNIX__ now
489 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
493 #if defined(__WXMOTIF__) || defined(__WXX11__)
499 # define __DIGITALMARS__
501 # define __SYMANTEC__
505 #ifdef __INTEL_COMPILER
510 We get "Large Files (ILP32) not supported in strict ANSI mode." #error
511 from HP-UX standard headers when compiling with g++ without this:
513 #if defined(__HPUX__) && !defined(__STDC_EXT__)
514 # define __STDC_EXT__ 1
517 /* Force linking against required libraries under Windows: */
519 # include "wx/msw/wince/libraries.h"
520 #elif defined __WINDOWS__
521 # include "wx/msw/libraries.h"
525 This macro can be used to test the gcc version and can be used like this:
527 # if wxCHECK_GCC_VERSION(3, 1)
528 ... we have gcc 3.1 or later ...
530 ... no gcc at all or gcc < 3.1 ...
533 #if defined(__GNUC__) && defined(__GNUC_MINOR__)
534 #define wxCHECK_GCC_VERSION( major, minor ) \
535 ( ( __GNUC__ > (major) ) \
536 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) )
538 #define wxCHECK_GCC_VERSION( major, minor ) 0
541 #if defined(__BORLANDC__) || (defined(__GNUC__) && __GNUC__ < 3)
542 #define wxNEEDS_CHARPP
546 This macro can be used to test the Visual C++ version.
549 # define wxVISUALC_VERSION(major) 0
550 # define wxCHECK_VISUALC_VERSION(major) 0
552 # define wxVISUALC_VERSION(major) ( (6 + major) * 100 )
553 # define wxCHECK_VISUALC_VERSION(major) ( __VISUALC__ >= wxVISUALC_VERSION(major) )
557 This macro can be used to check that the version of mingw32 compiler is
560 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
561 ( defined( __CYGWIN__ ) && defined( __WINDOWS__ ) ) || \
562 wxCHECK_WATCOM_VERSION(1,0) ) && \
563 !defined(__DOS__) && \
564 !defined(__WXPM__) && \
565 !defined(__WXMOTIF__) && \
566 !defined(__WXGTK__) && \
568 # include "wx/msw/gccpriv.h"
570 # undef wxCHECK_W32API_VERSION
571 # define wxCHECK_W32API_VERSION(maj, min) (0)
572 # undef wxCHECK_MINGW32_VERSION
573 # define wxCHECK_MINGW32_VERSION(maj, min) (0)
577 This is similar to wxCHECK_GCC_VERSION but for Sun CC compiler.
581 __SUNCC__ is 0xVRP where V is major version, R release and P patch level
583 #define wxCHECK_SUNCC_VERSION(maj, min) (__SUNCC__ >= (((maj)<<8) | ((min)<<4)))
585 #define wxCHECK_SUNCC_VERSION(maj, min) (0)
589 Handle Darwin gcc universal compilation. Don't do this in an Apple-
590 specific case since no sane compiler should be defining either
591 __BIG_ENDIAN__ or __LITTLE_ENDIAN__ unless it really is generating
592 code that will be hosted on a machine with the appropriate endianness.
593 If a compiler defines neither, assume the user or configure set
594 WORDS_BIGENDIAN appropriately.
596 #if defined(__BIG_ENDIAN__)
597 # undef WORDS_BIGENDIAN
598 # define WORDS_BIGENDIAN 1
599 #elif defined(__LITTLE_ENDIAN__)
600 # undef WORDS_BIGENDIAN
601 #elif defined(__WXMAC__) && !defined(WORDS_BIGENDIAN)
602 /* According to Stefan even ancient Mac compilers defined __BIG_ENDIAN__ */
603 # warning "Compiling wxMac with probably wrong endianness"
605 /* also the 32/64 bit universal builds must be handled accordingly */
608 # undef SIZEOF_VOID_P
610 # undef SIZEOF_SIZE_T
611 # define SIZEOF_VOID_P 8
612 # define SIZEOF_LONG 8
613 # define SIZEOF_SIZE_T 8
615 # undef SIZEOF_VOID_P
617 # undef SIZEOF_SIZE_T
618 # define SIZEOF_VOID_P 4
619 # define SIZEOF_LONG 4
620 # define SIZEOF_SIZE_T 4
625 Define various OS X symbols before including wx/chkconf.h which uses them.
627 __WXOSX_MAC__ means Mac OS X, non embedded
628 __WXOSX_IPHONE__ means OS X iPhone
632 Normally all of __WXOSX_XXX__, __WXOSX__ and __WXMAC__ are defined by
633 configure but ensure that we also define them if configure was not used for
636 The primary symbol remains __WXOSX_XXX__ one, __WXOSX__ exists to allow
637 checking for any OS X port (Carbon and Cocoa) and __WXMAC__ is an old name
640 #if defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__) || defined(__WXOSX_IPHONE__) \
641 || (defined(__DARWIN__) && !wxUSE_GUI)
651 /* setup precise defines according to sdk used */
652 # include <TargetConditionals.h>
653 # if defined(__WXOSX_IPHONE__)
654 # if !( defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE )
655 # error "incorrect SDK for an iPhone build"
658 # if wxUSE_GUI && !(defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__))
659 # error "one of __WXOSX_IPHONE__, __WXOSX_CARBON__ or __WXOSX_COCOA__ must be defined for the GUI build"
661 # if !( defined(TARGET_OS_MAC) && TARGET_OS_MAC )
662 # error "incorrect SDK for a Mac OS X build"
664 # define __WXOSX_MAC__ 1
669 # if defined(__MACH__)
670 # include <AvailabilityMacros.h>
671 # ifndef MAC_OS_X_VERSION_10_4
672 # define MAC_OS_X_VERSION_10_4 1040
674 # ifndef MAC_OS_X_VERSION_10_5
675 # define MAC_OS_X_VERSION_10_5 1050
677 # ifndef MAC_OS_X_VERSION_10_6
678 # define MAC_OS_X_VERSION_10_6 1060
681 # error "only mach-o configurations are supported"
686 __WXOSX_OR_COCOA__ is a common define to wxOSX (Carbon or Cocoa) and wxCocoa ports under OS X.
688 DO NOT use this define in base library code. Although wxMac has its own
689 private base library (and thus __WXOSX_OR_COCOA__,__WXMAC__ and related defines are
690 valid there), wxCocoa shares its library with other ports like wxGTK and wxX11.
692 To keep wx authors from screwing this up, only enable __WXOSX_OR_COCOA__ for wxCocoa when
693 not compiling the base library. We determine this by first checking if
694 wxUSE_BASE is not defined. If it is not defined, then we're not buildling
695 the base library, and possibly not building wx at all (but actually building
696 user code that's using wx). If it is defined then we must check to make sure
697 it is not true. If it is true, we're building base.
699 If you want it in the common darwin base library then use __DARWIN__. You
700 can use any Darwin-available libraries like CoreFoundation but please avoid
701 using OS X libraries like Carbon or CoreServices.
704 #if defined(__WXOSX__) || (defined(__WXCOCOA__) && (!defined(wxUSE_BASE) || !wxUSE_BASE))
705 # define __WXOSX_OR_COCOA__ 1
709 check the consistency of the settings in setup.h: note that this must be
710 done after setting wxUSE_UNICODE correctly as it is used in wx/chkconf.h
711 and after defining the compiler macros which are used in it too
713 #include "wx/chkconf.h"
717 some compilers don't support iostream.h any longer, while some of theme
718 are not updated with <iostream> yet, so override the users setting here
721 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
722 # undef wxUSE_IOSTREAMH
723 # define wxUSE_IOSTREAMH 0
724 #elif defined(__DMC__) || defined(__WATCOMC__)
725 # undef wxUSE_IOSTREAMH
726 # define wxUSE_IOSTREAMH 1
727 #elif defined(__MINGW32__)
728 # undef wxUSE_IOSTREAMH
729 # define wxUSE_IOSTREAMH 0
730 #endif /* compilers with/without iostream.h */
733 old C++ headers (like <iostream.h>) declare classes in the global namespace
734 while the new, standard ones (like <iostream>) do it in std:: namespace,
735 unless it's an old gcc version.
737 using this macro allows constuctions like "wxSTD iostream" to work in
740 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
746 /* On OpenVMS with the most recent HP C++ compiler some function (i.e. wscanf)
747 * are only available in the std-namespace. (BUG???)
749 #if defined( __VMS ) && (__DECCXX_VER >= 70100000) && !defined(__STD_CFRONT) && !defined( __NONAMESPACE_STD )
750 # define wxVMS_USE_STD std::
752 # define wxVMS_USE_STD
756 #define XtDisplay XTDISPLAY
758 #define XtParent XTPARENT
759 #define XtScreen XTSCREEN
760 #define XtWindow XTWINDOW
764 /* Choose which method we will use for updating menus
765 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
766 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
768 #ifndef wxUSE_IDLEMENUUPDATES
769 # if (defined(__WXMSW__) || defined(__WXGTK__) || defined(__WXOSX__)) && !defined(__WXUNIVERSAL__)
770 # define wxUSE_IDLEMENUUPDATES 0
772 # define wxUSE_IDLEMENUUPDATES 1
777 * Define symbols that are not yet in
778 * configure or possibly some setup.h files.
779 * They will need to be added.
782 #ifndef wxUSE_FILECONFIG
783 # if wxUSE_CONFIG && wxUSE_TEXTFILE
784 # define wxUSE_FILECONFIG 1
786 # define wxUSE_FILECONFIG 0
791 # define wxUSE_HOTKEY 0
794 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
795 # define wxUSE_WXDIB 1
799 Optionally supported C++ features.
803 RTTI: if it is disabled in build/msw/makefile.* then this symbol will
804 already be defined but it's also possible to do it from configure (with
805 g++) or by editing project files with MSVC so test for it here too.
809 Only 4.3 defines __GXX_RTTI by default so its absence is not an
810 indication of disabled RTTI with the previous versions.
812 # if wxCHECK_GCC_VERSION(4, 3)
816 # elif defined(_MSC_VER)
821 #endif /* wxNO_RTTI */
823 #endif /* _WX_PLATFORM_H_ */