]>
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 # include "wx/osx/config_xcode.h"
41 first define Windows symbols if they're not defined on the command line: we
42 can autodetect everything we need if _WIN32 is defined
44 #if defined(__CYGWIN__) && defined(__WINDOWS__)
53 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
54 Windows or to test for !__WIN16__, so we must define _WIN32 for
55 Win64 as well to ensure that the existing code continues to work.
62 # endif /* !__WIN64__ */
65 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
66 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
72 #if defined(__WXMSW__)
73 # if !defined(__WINDOWS__)
88 #endif /* __WXMSW__ */
90 /* detect MS SmartPhone */
91 #if defined( WIN32_PLATFORM_WFSP )
92 # ifndef __SMARTPHONE__
93 # define __SMARTPHONE__
100 /* detect PocketPC */
101 #if defined( WIN32_PLATFORM_PSPC )
102 # ifndef __POCKETPC__
103 # define __POCKETPC__
110 /* detect Standard WinCE SDK */
111 #if defined( WCE_PLATFORM_STANDARDSDK )
112 # ifndef __WINCE_STANDARDSDK__
113 # define __WINCE_STANDARDSDK__
120 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
121 # if (_WIN32_WCE >= 400)
122 # ifndef __WINCE_NET__
123 # define __WINCE_NET__
125 # elif (_WIN32_WCE >= 200)
126 # ifndef __HANDHELDPC__
127 # define __HANDHELDPC__
135 #if defined(__WXWINCE__) && defined(_MSC_VER) && (_MSC_VER == 1201)
139 #if defined(__POCKETPC__) || defined(__SMARTPHONE__) || defined(__WXGPE__)
140 # define __WXHANDHELD__
144 Include wx/setup.h for the Unix platform defines generated by configure and
145 the library compilation options
147 Note that it must be included before defining hardware symbols below as they
148 could be already defined by configure
150 #include "wx/setup.h"
154 we're using gccxml to create an XML representation of the entire
155 wxWidgets interface; use a special setup_gccxml.h file to fix some
156 of the stuff #defined by the real setup.h
158 #include "wx/setup_gccxml.h"
162 Convenience for any optional classes that use the wxAnyButton base class.
164 #if wxUSE_TOGGLEBTN || wxUSE_BUTTON
165 #define wxHAS_ANY_BUTTON
170 Hardware platform detection.
172 VC++ defines _M_xxx symbols.
174 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
186 #if defined(_M_MPPC) || defined(__PPC__) || defined(__ppc__)
192 #if defined(_M_ALPHA) || defined(__AXP__)
200 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
201 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
202 the system headers so bring these settings in sync
205 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
206 #if defined(_UNICODE) || defined(UNICODE)
207 # undef wxUSE_UNICODE
208 # define wxUSE_UNICODE 1
210 # ifndef wxUSE_UNICODE
211 # define wxUSE_UNICODE 0
213 #endif /* UNICODE/!UNICODE */
215 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
223 #endif /* wxUSE_UNICODE */
225 #if defined( __MWERKS__ ) && !defined(__INTEL__)
226 /* otherwise MSL headers bring in WIN32 dependant APIs */
232 test for old versions of Borland C, normally need at least 5.82, Turbo
233 explorer, available for free at http://www.turboexplorer.com/downloads
238 Older versions of Borland C have some compiler bugs that need
239 workarounds. Mostly pertains to the free command line compiler 5.5.1.
241 #if defined(__BORLANDC__) && (__BORLANDC__ <= 0x551)
243 The Borland free compiler is unable to handle overloaded enum
244 comparisons under certain conditions e.g. when any class has a
245 conversion ctor for an integral type and there's an overload to
246 compare between an integral type and that class type.
248 # define wxCOMPILER_NO_OVERLOAD_ON_ENUM
251 This is needed to overcome bugs in 5.5.1 STL, linking errors will
252 result if it is not defined.
254 # define _RWSTD_COMPILE_INSTANTIATE
257 Preprocessor in older Borland compilers have major problems
258 concatenating with ##. Specifically, if the string operands being
259 concatenated have special meaning (e.g. L"str", 123i64 etc)
260 then ## will not concatenate the operands correctly.
262 As a workaround, define wxPREPEND* and wxAPPEND* without using
265 # define wxCOMPILER_BROKEN_CONCAT_OPER
266 #endif /* __BORLANDC__ */
269 Define Watcom-specific macros.
272 # define wxWATCOM_VERSION(major,minor) 0
273 # define wxCHECK_WATCOM_VERSION(major,minor) 0
274 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) 0
275 # define WX_WATCOM_ONLY_CODE( x )
277 # if __WATCOMC__ < 1200
278 # error "Only Open Watcom is supported in this release"
281 # define wxWATCOM_VERSION(major,minor) ( major * 100 + minor * 10 + 1100 )
282 # define wxCHECK_WATCOM_VERSION(major,minor) ( __WATCOMC__ >= wxWATCOM_VERSION(major,minor) )
283 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) ( __WATCOMC__ < wxWATCOM_VERSION(major,minor) )
284 # define WX_WATCOM_ONLY_CODE( x ) x
288 OS: first of all, test for MS-DOS platform. We must do this before testing
289 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
291 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
295 /* size_t is the same as unsigned int for Watcom 11 compiler, */
296 /* so define it if it hadn't been done by configure yet */
297 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
299 # define wxSIZE_T_IS_UINT
302 # define wxSIZE_T_IS_ULONG
307 OS: then test for generic Unix defines, then for particular flavours and
308 finally for Unix-like systems
309 Mac OS X matches this case (__MACH__), prior Mac OS do not.
311 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
312 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
313 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
314 defined(__EMX__) || defined(__VMS) || defined(__BEOS__) || defined(__MACH__)
316 # define __UNIX_LIKE__
318 /* Helps SGI compilation, apparently */
321 # define __need_wchar_t
324 Note I use the term __SGI_CC__ for both cc and CC, its not a good
325 idea to mix gcc and cc/CC, the name mangling is different
328 # endif /* gcc/!gcc */
330 /* system headers use this symbol and not __cplusplus in some places */
331 # ifndef _LANGUAGE_C_PLUS_PLUS
332 # define _LANGUAGE_C_PLUS_PLUS
336 # if defined(__SUNPRO_CC)
338 # define __SUNCC__ __SUNPRO_CC
343 # define OS2EMX_PLAIN_CHAR
345 # if defined(__INNOTEK_LIBC__)
346 /* Ensure visibility of strnlen declaration */
350 /* define __HPUX__ for HP-UX where standard macro is __hpux */
351 # if defined(__hpux) && !defined(__HPUX__)
355 # if defined(__CYGWIN__) || defined(__WINE__)
356 # if !defined(wxSIZE_T_IS_UINT)
357 # define wxSIZE_T_IS_UINT
361 /* All of these should already be defined by including configure-
362 generated setup.h but we wish to support Xcode compilation without
363 requiring the user to define these himself.
365 # if defined(__APPLE__) && defined(__MACH__)
372 /* __DARWIN__ is our own define to mean OS X or pure Darwin */
374 # define __DARWIN__ 1
376 /* NOTE: TARGET_CARBON is actually a 0/1 and must be 1 for OS X */
377 # ifndef TARGET_CARBON
378 # define TARGET_CARBON 1
380 /* OS X uses unsigned long size_t for both ILP32 and LP64 modes. */
381 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
382 # define wxSIZE_T_IS_ULONG
389 #elif defined(applec) || \
390 defined(THINK_C) || \
391 (defined(__MWERKS__) && !defined(__INTEL__))
393 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
394 # define wxSIZE_T_IS_ULONG
400 #elif defined(__OS2__)
402 /* wxOS2 vs. non wxOS2 ports on OS2 platform */
403 # if !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
409 # if defined(__IBMCPP__)
410 # define __VISAGEAVER__ __IBMCPP__
413 /* Place other OS/2 compiler environment defines here */
414 # if defined(__VISAGECPP__)
415 /* VisualAge is the only thing that understands _Optlink */
416 # define LINKAGEMODE _Optlink
418 # define wxSIZE_T_IS_UINT
421 OS: Otherwise it must be Windows
426 # endif /* Windows */
428 /* to be changed for Win64! */
430 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
434 define another standard symbol for Microsoft Visual C++: the standard
435 one (_MSC_VER) is also defined by Metrowerks compiler
437 # if defined(_MSC_VER) && !defined(__MWERKS__)
438 # define __VISUALC__ _MSC_VER
441 define special symbols for different VC version instead of writing tests
442 for magic numbers such as 1200, 1300 &c repeatedly
444 # if __VISUALC__ < 1100
445 # error "This Visual C++ version is too old and not supported any longer."
446 # elif __VISUALC__ < 1200
447 # define __VISUALC5__
448 # elif __VISUALC__ < 1300
449 # define __VISUALC6__
450 # elif __VISUALC__ < 1400
451 # define __VISUALC7__
452 # elif __VISUALC__ < 1500
453 # define __VISUALC8__
454 # elif __VISUALC__ < 1600
455 # define __VISUALC9__
456 # elif __VISUALC__ < 1700
457 # define __VISUALC10__
459 # pragma message("Please update wx/platform.h to recognize this VC++ version")
462 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
463 # define __BORLANDC__
464 # elif defined(__WATCOMC__)
465 # elif defined(__SC__)
466 # define __SYMANTECC__
467 # endif /* compiler */
469 /* size_t is the same as unsigned int for all Windows compilers we know, */
470 /* so define it if it hadn't been done by configure yet */
471 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG) && !defined(__WIN64__)
472 # define wxSIZE_T_IS_UINT
477 if we're on a Unix system but didn't use configure (so that setup.h didn't
478 define __UNIX__), do define __UNIX__ now
480 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
484 #if defined(__WXMOTIF__) || defined(__WXX11__)
490 # define __DIGITALMARS__
492 # define __SYMANTEC__
496 #ifdef __INTEL_COMPILER
501 We get "Large Files (ILP32) not supported in strict ANSI mode." #error
502 from HP-UX standard headers when compiling with g++ without this:
504 #if defined(__HPUX__) && !defined(__STDC_EXT__)
505 # define __STDC_EXT__ 1
508 /* Force linking against required libraries under Windows: */
510 # include "wx/msw/wince/libraries.h"
511 #elif defined __WINDOWS__
512 # include "wx/msw/libraries.h"
516 This macro can be used to test the gcc version and can be used like this:
518 # if wxCHECK_GCC_VERSION(3, 1)
519 ... we have gcc 3.1 or later ...
521 ... no gcc at all or gcc < 3.1 ...
524 #if defined(__GNUC__) && defined(__GNUC_MINOR__)
525 #define wxCHECK_GCC_VERSION( major, minor ) \
526 ( ( __GNUC__ > (major) ) \
527 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) )
529 #define wxCHECK_GCC_VERSION( major, minor ) 0
532 #if defined(__BORLANDC__) || (defined(__GNUC__) && __GNUC__ < 3)
533 #define wxNEEDS_CHARPP
537 This macro can be used to test the Visual C++ version.
540 # define wxVISUALC_VERSION(major) 0
541 # define wxCHECK_VISUALC_VERSION(major) 0
543 # define wxVISUALC_VERSION(major) ( (6 + major) * 100 )
544 # define wxCHECK_VISUALC_VERSION(major) ( __VISUALC__ >= wxVISUALC_VERSION(major) )
548 This macro can be used to check that the version of mingw32 compiler is
551 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
552 ( defined( __CYGWIN__ ) && defined( __WINDOWS__ ) ) || \
553 wxCHECK_WATCOM_VERSION(1,0) ) && \
554 !defined(__DOS__) && \
555 !defined(__WXPM__) && \
556 !defined(__WXMOTIF__) && \
557 !defined(__WXGTK__) && \
559 # include "wx/msw/gccpriv.h"
561 # undef wxCHECK_W32API_VERSION
562 # define wxCHECK_W32API_VERSION(maj, min) (0)
563 # undef wxCHECK_MINGW32_VERSION
564 # define wxCHECK_MINGW32_VERSION(maj, min) (0)
568 This is similar to wxCHECK_GCC_VERSION but for Sun CC compiler.
572 __SUNCC__ is 0xVRP where V is major version, R release and P patch level
574 #define wxCHECK_SUNCC_VERSION(maj, min) (__SUNCC__ >= (((maj)<<8) | ((min)<<4)))
576 #define wxCHECK_SUNCC_VERSION(maj, min) (0)
580 Handle Darwin gcc universal compilation. Don't do this in an Apple-
581 specific case since no sane compiler should be defining either
582 __BIG_ENDIAN__ or __LITTLE_ENDIAN__ unless it really is generating
583 code that will be hosted on a machine with the appropriate endianness.
584 If a compiler defines neither, assume the user or configure set
585 WORDS_BIGENDIAN appropriately.
587 #if defined(__BIG_ENDIAN__)
588 # undef WORDS_BIGENDIAN
589 # define WORDS_BIGENDIAN 1
590 #elif defined(__LITTLE_ENDIAN__)
591 # undef WORDS_BIGENDIAN
592 #elif defined(__WXMAC__) && !defined(WORDS_BIGENDIAN)
593 /* According to Stefan even ancient Mac compilers defined __BIG_ENDIAN__ */
594 # warning "Compiling wxMac with probably wrong endianness"
596 /* also the 32/64 bit universal builds must be handled accordingly */
599 # undef SIZEOF_VOID_P
601 # undef SIZEOF_SIZE_T
602 # define SIZEOF_VOID_P 8
603 # define SIZEOF_LONG 8
604 # define SIZEOF_SIZE_T 8
606 # undef SIZEOF_VOID_P
608 # undef SIZEOF_SIZE_T
609 # define SIZEOF_VOID_P 4
610 # define SIZEOF_LONG 4
611 # define SIZEOF_SIZE_T 4
616 Define various OS X symbols before including wx/chkconf.h which uses them.
618 __WXOSX_MAC__ means Mac OS X, non embedded
619 __WXOSX_IPHONE__ means OS X iPhone
623 Normally all of __WXOSX_XXX__, __WXOSX__ and __WXMAC__ are defined by
624 configure but ensure that we also define them if configure was not used for
627 The primary symbol remains __WXOSX_XXX__ one, __WXOSX__ exists to allow
628 checking for any OS X port (Carbon and Cocoa) and __WXMAC__ is an old name
631 #if defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__) || defined(__WXOSX_IPHONE__) \
632 || (defined(__DARWIN__) && !wxUSE_GUI)
642 /* setup precise defines according to sdk used */
643 # include <TargetConditionals.h>
644 # if defined(__WXOSX_IPHONE__)
645 # if !( defined(TARGET_OS_IPHONE) && TARGET_OS_IPHONE )
646 # error "incorrect SDK for an iPhone build"
649 # if wxUSE_GUI && !(defined(__WXOSX_CARBON__) || defined(__WXOSX_COCOA__))
650 # error "one of __WXOSX_IPHONE__, __WXOSX_CARBON__ or __WXOSX_COCOA__ must be defined for the GUI build"
652 # if !( defined(TARGET_OS_MAC) && TARGET_OS_MAC )
653 # error "incorrect SDK for a Mac OS X build"
655 # define __WXOSX_MAC__ 1
660 # if defined(__MACH__)
661 # include <AvailabilityMacros.h>
662 # ifndef MAC_OS_X_VERSION_10_4
663 # define MAC_OS_X_VERSION_10_4 1040
665 # ifndef MAC_OS_X_VERSION_10_5
666 # define MAC_OS_X_VERSION_10_5 1050
668 # ifndef MAC_OS_X_VERSION_10_6
669 # define MAC_OS_X_VERSION_10_6 1060
672 # error "only mach-o configurations are supported"
677 __WXOSX_OR_COCOA__ is a common define to wxOSX (Carbon or Cocoa) and wxCocoa ports under OS X.
679 DO NOT use this define in base library code. Although wxMac has its own
680 private base library (and thus __WXOSX_OR_COCOA__,__WXMAC__ and related defines are
681 valid there), wxCocoa shares its library with other ports like wxGTK and wxX11.
683 To keep wx authors from screwing this up, only enable __WXOSX_OR_COCOA__ for wxCocoa when
684 not compiling the base library. We determine this by first checking if
685 wxUSE_BASE is not defined. If it is not defined, then we're not buildling
686 the base library, and possibly not building wx at all (but actually building
687 user code that's using wx). If it is defined then we must check to make sure
688 it is not true. If it is true, we're building base.
690 If you want it in the common darwin base library then use __DARWIN__. You
691 can use any Darwin-available libraries like CoreFoundation but please avoid
692 using OS X libraries like Carbon or CoreServices.
695 #if defined(__WXOSX__) || (defined(__WXCOCOA__) && (!defined(wxUSE_BASE) || !wxUSE_BASE))
696 # define __WXOSX_OR_COCOA__ 1
700 check the consistency of the settings in setup.h: note that this must be
701 done after setting wxUSE_UNICODE correctly as it is used in wx/chkconf.h
702 and after defining the compiler macros which are used in it too
704 #include "wx/chkconf.h"
708 some compilers don't support iostream.h any longer, while some of theme
709 are not updated with <iostream> yet, so override the users setting here
712 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
713 # undef wxUSE_IOSTREAMH
714 # define wxUSE_IOSTREAMH 0
715 #elif defined(__DMC__) || defined(__WATCOMC__)
716 # undef wxUSE_IOSTREAMH
717 # define wxUSE_IOSTREAMH 1
718 #elif defined(__MINGW32__)
719 # undef wxUSE_IOSTREAMH
720 # define wxUSE_IOSTREAMH 0
721 #endif /* compilers with/without iostream.h */
724 old C++ headers (like <iostream.h>) declare classes in the global namespace
725 while the new, standard ones (like <iostream>) do it in std:: namespace,
726 unless it's an old gcc version.
728 using this macro allows constuctions like "wxSTD iostream" to work in
731 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
737 /* On OpenVMS with the most recent HP C++ compiler some function (i.e. wscanf)
738 * are only available in the std-namespace. (BUG???)
740 #if defined( __VMS ) && (__DECCXX_VER >= 70100000) && !defined(__STD_CFRONT) && !defined( __NONAMESPACE_STD )
741 # define wxVMS_USE_STD std::
743 # define wxVMS_USE_STD
747 #define XtDisplay XTDISPLAY
749 #define XtParent XTPARENT
750 #define XtScreen XTSCREEN
751 #define XtWindow XTWINDOW
755 /* Choose which method we will use for updating menus
756 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
757 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
759 #ifndef wxUSE_IDLEMENUUPDATES
760 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
761 # define wxUSE_IDLEMENUUPDATES 0
763 # define wxUSE_IDLEMENUUPDATES 1
768 * Define symbols that are not yet in
769 * configure or possibly some setup.h files.
770 * They will need to be added.
773 #ifndef wxUSE_FILECONFIG
774 # if wxUSE_CONFIG && wxUSE_TEXTFILE
775 # define wxUSE_FILECONFIG 1
777 # define wxUSE_FILECONFIG 0
782 # define wxUSE_HOTKEY 0
785 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
786 # define wxUSE_WXDIB 1
790 Optionally supported C++ features.
794 RTTI: if it is disabled in build/msw/makefile.* then this symbol will
795 already be defined but it's also possible to do it from configure (with
796 g++) or by editing project files with MSVC so test for it here too.
800 Only 4.3 defines __GXX_RTTI by default so its absence is not an
801 indication of disabled RTTI with the previous versions.
803 # if wxCHECK_GCC_VERSION(4, 3)
807 # elif defined(_MSC_VER)
812 #endif /* wxNO_RTTI */
814 #endif /* _WX_PLATFORM_H_ */