]> git.saurik.com Git - wxWidgets.git/blob - include/wx/platform.h
Document the cfstring.h/cfstring.cpp as being used by all Darwin ports (it's
[wxWidgets.git] / include / wx / platform.h
1 /**
2 * Name: wx/platform.h
3 * Purpose: define the OS and compiler identification macros
4 * Author: Vadim Zeitlin
5 * Modified by:
6 * Created: 29.10.01 (extracted from wx/defs.h)
7 * RCS-ID: $Id$
8 * Copyright: (c) 1997-2001 Vadim Zeitlin
9 * Licence: wxWindows licence
10 */
11
12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
13
14 #ifndef _WX_PLATFORM_H_
15 #define _WX_PLATFORM_H_
16
17
18 /*
19 Codewarrior doesn't define any Windows symbols until some headers
20 are included
21 */
22 #ifdef __MWERKS__
23 # include <stddef.h>
24 #endif
25
26 /*
27 WXMAC variants
28 __WXMAC_CLASSIC__ means ppc non-carbon builds, __WXMAC_CARBON__ means
29 carbon API available (mach or cfm builds) , __WXMAC_OSX__ means mach-o
30 builds, running under 10.2 + only
31 */
32 #ifdef __WXMAC__
33 # if defined(__MACH__)
34 # define __WXMAC_OSX__
35 # define __WXMAC_CARBON__ /* for backwards compat in user code still defined */
36 # include <AvailabilityMacros.h>
37 # ifndef MAC_OS_X_VERSION_10_4
38 # define MAC_OS_X_VERSION_10_4 1040
39 # endif
40 # ifndef MAC_OS_X_VERSION_10_5
41 # define MAC_OS_X_VERSION_10_5 1050
42 # endif
43 # ifdef __WXMAC_XCODE__
44 # include <unistd.h>
45 # include "wx/mac/carbon/config_xcode.h"
46 # endif
47 # else
48 # error "only mach-o configurations are supported"
49 # endif
50 #endif
51
52 /*
53 __WXOSX__ is a common define to wxMac (Carbon) and wxCocoa ports under OS X.
54 */
55 #if defined(__WXMAC_OSX__) || defined(__WXCOCOA__)
56 # define __WXOSX__
57 #endif
58
59 /*
60 first define Windows symbols if they're not defined on the command line: we
61 can autodetect everything we need if _WIN32 is defined
62 */
63 #if defined(__CYGWIN__) && defined(__WINDOWS__)
64 # ifndef __WXMSW__
65 # define __WXMSW__
66 # endif
67
68 # ifndef _WIN32
69 # define _WIN32
70 # endif
71
72 # ifndef WIN32
73 # define WIN32
74 # endif
75 #endif
76
77 #if defined(__PALMOS__)
78 # if __PALMOS__ == 0x06000000
79 # define __WXPALMOS6__
80 # endif
81 # if __PALMOS__ == 0x05000000
82 # define __WXPALMOS5__
83 # endif
84 # ifndef __WXPALMOS__
85 # define __WXPALMOS__
86 # endif
87 # ifdef __WXMSW__
88 # undef __WXMSW__
89 # endif
90 # ifdef __WINDOWS__
91 # undef __WINDOWS__
92 # endif
93 # ifdef __WIN32__
94 # undef __WIN32__
95 # endif
96 # ifdef WIN32
97 # undef WIN32
98 # endif
99 # ifdef _WIN32
100 # undef _WIN32
101 # endif
102 #endif
103
104 #if defined(_WIN64)
105 # ifndef _WIN32
106 /*
107 a lot of code (mistakenly) uses #ifdef _WIN32 to either test for
108 Windows or to test for !__WIN16__, so we must define _WIN32 for
109 Win64 as well to ensure that the existing code continues to work.
110 */
111 # define _WIN32
112 # endif /* !_WIN32 */
113
114 # ifndef __WIN64__
115 # define __WIN64__
116 # endif /* !__WIN64__ */
117 #endif /* _WIN64 */
118
119 #if (defined(_WIN32) || defined(WIN32) || defined(__NT__) || defined(__WXWINCE__)) \
120 && !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
121 # ifndef __WXMSW__
122 # define __WXMSW__
123 # endif
124
125 # ifndef __WIN32__
126 # define __WIN32__
127 # endif
128 #endif /* Win32 */
129
130 #if defined(__WXMSW__) || defined(__WIN32__)
131 # if !defined(__WINDOWS__)
132 # define __WINDOWS__
133 # endif
134 #endif
135
136 /* detect MS SmartPhone */
137 #if defined( WIN32_PLATFORM_WFSP )
138 # ifndef __SMARTPHONE__
139 # define __SMARTPHONE__
140 # endif
141 # ifndef __WXWINCE__
142 # define __WXWINCE__
143 # endif
144 #endif
145
146 /* detect PocketPC */
147 #if defined( WIN32_PLATFORM_PSPC )
148 # ifndef __POCKETPC__
149 # define __POCKETPC__
150 # endif
151 # ifndef __WXWINCE__
152 # define __WXWINCE__
153 # endif
154 #endif
155
156 /* detect Standard WinCE SDK */
157 #if defined( WCE_PLATFORM_STANDARDSDK )
158 # ifndef __WINCE_STANDARDSDK__
159 # define __WINCE_STANDARDSDK__
160 # endif
161 # ifndef __WXWINCE__
162 # define __WXWINCE__
163 # endif
164 #endif
165
166 #if defined(_WIN32_WCE) && !defined(WIN32_PLATFORM_WFSP) && !defined(WIN32_PLATFORM_PSPC)
167 # if (_WIN32_WCE >= 400)
168 # ifndef __WINCE_NET__
169 # define __WINCE_NET__
170 # endif
171 # elif (_WIN32_WCE >= 200)
172 # ifndef __HANDHELDPC__
173 # define __HANDHELDPC__
174 # endif
175 # endif
176 # ifndef __WXWINCE__
177 # define __WXWINCE__
178 # endif
179 #endif
180
181 #if defined(__POCKETPC__) || defined(__SMARTPHONE__) || defined(__WXGPE__)
182 # define __WXHANDHELD__
183 #endif
184
185 /*
186 Include wx/setup.h for the Unix platform defines generated by configure and
187 the library compilation options
188
189 Note that it must be included before defining hardware symbols below as they
190 could be already defined by configure
191 */
192 #include "wx/setup.h"
193
194 /*
195 Hardware platform detection.
196
197 VC++ defines _M_xxx symbols.
198 */
199 #if defined(_M_IX86) || defined(i386) || defined(__i386) || defined(__i386__)
200 #ifndef __INTEL__
201 #define __INTEL__
202 #endif
203 #endif /* x86 */
204
205 #if defined(_M_IA64)
206 #ifndef __IA64__
207 #define __IA64__
208 #endif
209 #endif /* ia64 */
210
211 #if defined(_M_MPPC) || defined(__PPC__) || defined(__ppc__)
212 #ifndef __POWERPC__
213 #define __POWERPC__
214 #endif
215 #endif /* alpha */
216
217 #if defined(_M_ALPHA) || defined(__AXP__)
218 #ifndef __ALPHA__
219 #define __ALPHA__
220 #endif
221 #endif /* alpha */
222
223
224 /*
225 adjust the Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
226 and is used by wxWidgets, _UNICODE and/or UNICODE may be defined or used by
227 the system headers so bring these settings in sync
228 */
229
230 /* set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined */
231 #if defined(_UNICODE) || defined(UNICODE)
232 # undef wxUSE_UNICODE
233 # define wxUSE_UNICODE 1
234 #else /* !UNICODE */
235 # ifndef wxUSE_UNICODE
236 # define wxUSE_UNICODE 0
237 # endif
238 #endif /* UNICODE/!UNICODE */
239
240 /* and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1 */
241 #if wxUSE_UNICODE
242 # ifndef _UNICODE
243 # define _UNICODE
244 # endif
245 # ifndef UNICODE
246 # define UNICODE
247 # endif
248 #endif /* wxUSE_UNICODE */
249
250 #if defined( __MWERKS__ ) && !defined(__INTEL__)
251 /* otherwise MSL headers bring in WIN32 dependant APIs */
252 #undef UNICODE
253 #endif
254
255
256 /* test for old versions of Borland C, normally need at least 5.82, Turbo explorer,
257 available for free at http://www.turboexplorer.com/downloads
258 */
259 #if defined(__BORLANDC__) && (__BORLANDC__ < 0x550)
260 #error "This version of wxWidgets requires a newer version of Borland - we recommend 5.82 (Turbo Explorer); You may at your own risk remove this line and try your system"
261 #endif /* __BORLANDC__ */
262
263 #if defined(__BORLANDC__) && (__BORLANDC__ < 0x582) && (__BORLANDC__ > 0x559)
264 #error "This version of wxWidgets has problems with Borland 5.6; we recommend getting Borland 5.82 (Turbo Explorer); You may at your own risk remove this line and try your system"
265 #endif /* __BORLANDC__ */
266
267
268 /*
269 This macro can be used to test the Open Watcom version.
270 */
271 #ifndef __WATCOMC__
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 #elif defined(__WATCOMC__) && __WATCOMC__ < 1200
276 # error "Only Open Watcom is supported in this release"
277 #else
278 # define wxWATCOM_VERSION(major,minor) ( major * 100 + minor * 10 + 1100 )
279 # define wxCHECK_WATCOM_VERSION(major,minor) ( __WATCOMC__ >= wxWATCOM_VERSION(major,minor) )
280 # define wxONLY_WATCOM_EARLIER_THAN(major,minor) ( __WATCOMC__ < wxWATCOM_VERSION(major,minor) )
281 #endif
282
283 /*
284 OS: first of all, test for MS-DOS platform. We must do this before testing
285 for Unix, because DJGPP compiler defines __unix__ under MS-DOS
286 */
287 #if defined(__GO32__) || defined(__DJGPP__) || defined(__DOS__)
288 # ifndef __DOS__
289 # define __DOS__
290 # endif
291 /* size_t is the same as unsigned int for Watcom 11 compiler, */
292 /* so define it if it hadn't been done by configure yet */
293 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
294 # ifdef __WATCOMC__
295 # define wxSIZE_T_IS_UINT
296 # endif
297 # ifdef __DJGPP__
298 # define wxSIZE_T_IS_ULONG
299 # endif
300 # endif
301
302 /*
303 OS: then test for generic Unix defines, then for particular flavours and
304 finally for Unix-like systems
305 Mac OS X matches this case (__MACH__), prior Mac OS do not.
306 */
307 #elif defined(__UNIX__) || defined(__unix) || defined(__unix__) || \
308 defined(____SVR4____) || defined(__LINUX__) || defined(__sgi) || \
309 defined(__hpux) || defined(sun) || defined(__SUN__) || defined(_AIX) || \
310 defined(__EMX__) || defined(__VMS) || defined(__BEOS__) || defined(__MACH__)
311
312 # define __UNIX_LIKE__
313
314 /* Helps SGI compilation, apparently */
315 # ifdef __SGI__
316 # ifdef __GNUG__
317 # define __need_wchar_t
318 # else /* !gcc */
319 /*
320 Note I use the term __SGI_CC__ for both cc and CC, its not a good
321 idea to mix gcc and cc/CC, the name mangling is different
322 */
323 # define __SGI_CC__
324 # endif /* gcc/!gcc */
325
326 /* system headers use this symbol and not __cplusplus in some places */
327 # ifndef _LANGUAGE_C_PLUS_PLUS
328 # define _LANGUAGE_C_PLUS_PLUS
329 # endif
330 # endif /* SGI */
331
332 # if defined(__SUNPRO_CC)
333 # ifndef __SUNCC__
334 # define __SUNCC__ __SUNPRO_CC
335 # endif /* Sun CC */
336 # endif /* Sun CC */
337
338 # ifdef __EMX__
339 # define OS2EMX_PLAIN_CHAR
340 # endif
341
342 /* define __HPUX__ for HP-UX where standard macro is __hpux */
343 # if defined(__hpux) && !defined(__HPUX__)
344 # define __HPUX__
345 # endif /* HP-UX */
346
347 # if defined(__CYGWIN__) || defined(__WINE__)
348 # if !defined(wxSIZE_T_IS_UINT)
349 # define wxSIZE_T_IS_UINT
350 # endif
351 # endif
352
353 /* All of these should already be defined by including configure-
354 generated setup.h but we wish to support Xcode compilation without
355 requiring the user to define these himself.
356 */
357 # if defined(__APPLE__) && defined(__MACH__)
358 # ifndef __UNIX__
359 # define __UNIX__ 1
360 # endif
361 # ifndef __BSD__
362 # define __BSD__ 1
363 # endif
364 /* __DARWIN__ is our own define to mean OS X or pure Darwin */
365 # ifndef __DARWIN__
366 # define __DARWIN__ 1
367 # endif
368 /* NOTE: TARGET_CARBON is actually a 0/1 and must be 1 for OS X */
369 # ifndef TARGET_CARBON
370 # define TARGET_CARBON 1
371 # endif
372 /* OS X uses unsigned long size_t for both ILP32 and LP64 modes. */
373 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
374 # define wxSIZE_T_IS_ULONG
375 # endif
376 # endif
377
378 /*
379 OS: Classic Mac OS
380 */
381 #elif defined(applec) || \
382 defined(THINK_C) || \
383 (defined(__MWERKS__) && !defined(__INTEL__))
384 /* MacOS */
385 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
386 # define wxSIZE_T_IS_ULONG
387 # endif
388
389 /*
390 OS: OS/2
391 */
392 #elif defined(__OS2__)
393
394 /* wxOS2 vs. non wxOS2 ports on OS2 platform */
395 # if !defined(__WXMOTIF__) && !defined(__WXGTK__) && !defined(__WXX11__)
396 # ifndef __WXPM__
397 # define __WXPM__
398 # endif
399 # endif
400
401 # if defined(__IBMCPP__)
402 # define __VISAGEAVER__ __IBMCPP__
403 # endif
404
405 /* Place other OS/2 compiler environment defines here */
406 # if defined(__VISAGECPP__)
407 /* VisualAge is the only thing that understands _Optlink */
408 # define LINKAGEMODE _Optlink
409 # endif
410 # define wxSIZE_T_IS_UINT
411
412 /*
413 OS: Palm OS
414 */
415 #elif defined(__PALMOS__)
416 # ifdef __WIN32__
417 # error "__WIN32__ should not be defined for PalmOS"
418 # endif
419 # ifdef __WINDOWS__
420 # error "__WINDOWS__ should not be defined for PalmOS"
421 # endif
422 # ifdef __WXMSW__
423 # error "__WXMSW__ should not be defined for PalmOS"
424 # endif
425
426 /*
427 OS: Otherwise it must be Windows
428 */
429 #else /* Windows */
430 # ifndef __WINDOWS__
431 # define __WINDOWS__
432 # endif /* Windows */
433
434 /* to be changed for Win64! */
435 # ifndef __WIN32__
436 # error "__WIN32__ should be defined for Win32 and Win64, Win16 is not supported"
437 # endif
438
439 /*
440 define another standard symbol for Microsoft Visual C++: the standard
441 one (_MSC_VER) is also defined by Metrowerks compiler
442 */
443 # if defined(_MSC_VER) && !defined(__MWERKS__)
444 # define __VISUALC__ _MSC_VER
445 # elif defined(__BCPLUSPLUS__) && !defined(__BORLANDC__)
446 # define __BORLANDC__
447 # elif defined(__WATCOMC__)
448 # elif defined(__SC__)
449 # define __SYMANTECC__
450 # endif /* compiler */
451
452 /* size_t is the same as unsigned int for all Windows compilers we know, */
453 /* so define it if it hadn't been done by configure yet */
454 # if !defined(wxSIZE_T_IS_UINT) && !defined(wxSIZE_T_IS_ULONG)
455 # define wxSIZE_T_IS_UINT
456 # endif
457 #endif /* OS */
458
459 /*
460 if we're on a Unix system but didn't use configure (so that setup.h didn't
461 define __UNIX__), do define __UNIX__ now
462 */
463 #if !defined(__UNIX__) && defined(__UNIX_LIKE__)
464 # define __UNIX__
465 #endif /* Unix */
466
467 #if defined(__WXMOTIF__) || defined(__WXX11__)
468 # define __X__
469 #endif
470
471 #ifdef __SC__
472 # ifdef __DMC__
473 # define __DIGITALMARS__
474 # else
475 # define __SYMANTEC__
476 # endif
477 #endif
478
479 #ifdef __INTEL_COMPILER
480 # define __INTELC__
481 #endif
482
483 /*
484 We get "Large Files (ILP32) not supported in strict ANSI mode." #error
485 from HP-UX standard headers when compiling with g++ without this:
486 */
487 #if defined(__HPUX__) && !defined(__STDC_EXT__)
488 # define __STDC_EXT__ 1
489 #endif
490
491 /* Force linking against required libraries under Windows: */
492 #ifdef __WXWINCE__
493 # include "wx/msw/wince/libraries.h"
494 #elif defined __WINDOWS__
495 # include "wx/msw/libraries.h"
496 #endif
497
498 /*
499 This macro can be used to test the gcc version and can be used like this:
500
501 # if wxCHECK_GCC_VERSION(3, 1)
502 ... we have gcc 3.1 or later ...
503 # else
504 ... no gcc at all or gcc < 3.1 ...
505 # endif
506 */
507 #if defined(__GNUC__) && defined(__GNUC_MINOR__)
508 #define wxCHECK_GCC_VERSION( major, minor ) \
509 ( ( __GNUC__ > (major) ) \
510 || ( __GNUC__ == (major) && __GNUC_MINOR__ >= (minor) ) )
511 #else
512 #define wxCHECK_GCC_VERSION( major, minor ) 0
513 #endif
514
515 #if defined(__BORLANDC__) || (defined(__GNUC__) && __GNUC__ < 3)
516 #define wxNEEDS_CHARPP
517 #endif
518
519 /*
520 This macro can be used to check that the version of mingw32 compiler is
521 at least maj.min
522 */
523 #if ( defined( __GNUWIN32__ ) || defined( __MINGW32__ ) || \
524 ( defined( __CYGWIN__ ) && defined( __WINDOWS__ ) ) || \
525 wxCHECK_WATCOM_VERSION(1,0) ) && \
526 !defined(__DOS__) && \
527 !defined(__WXPM__) && \
528 !defined(__WXMOTIF__) && \
529 !defined(__WXGTK__) && \
530 !defined(__WXX11__) && \
531 !defined(__WXPALMOS__)
532 # include "wx/msw/gccpriv.h"
533 #else
534 # undef wxCHECK_W32API_VERSION
535 # define wxCHECK_W32API_VERSION(maj, min) (0)
536 #endif
537
538 /**
539 This is similar to wxCHECK_GCC_VERSION but for Sun CC compiler.
540 */
541 #ifdef __SUNCC__
542 /*
543 __SUNCC__ is 0xVRP where V is major version, R release and P patch level
544 */
545 #define wxCHECK_SUNCC_VERSION(maj, min) (__SUNCC__ >= (((maj)<<8) | ((min)<<4)))
546 #else
547 #define wxCHECK_SUNCC_VERSION(maj, min) (0)
548 #endif
549
550 #if defined (__WXMSW__)
551 # if !defined(__WATCOMC__)
552 # define wxHAVE_RAW_BITMAP
553 # endif
554 #endif
555
556 /*
557 Handle Darwin gcc universal compilation. Don't do this in an Apple-
558 specific case since no sane compiler should be defining either
559 __BIG_ENDIAN__ or __LITTLE_ENDIAN__ unless it really is generating
560 code that will be hosted on a machine with the appropriate endianness.
561 If a compiler defines neither, assume the user or configure set
562 WORDS_BIGENDIAN appropriately.
563 */
564 #if defined(__BIG_ENDIAN__)
565 # undef WORDS_BIGENDIAN
566 # define WORDS_BIGENDIAN 1
567 #elif defined(__LITTLE_ENDIAN__)
568 # undef WORDS_BIGENDIAN
569 #elif defined(__WXMAC__) && !defined(WORDS_BIGENDIAN)
570 /* According to Stefan even ancient Mac compilers defined __BIG_ENDIAN__ */
571 # warning "Compiling wxMac with probably wrong endianness"
572 #endif
573
574 /*
575 check the consistency of the settings in setup.h: note that this must be
576 done after setting wxUSE_UNICODE correctly as it is used in wx/chkconf.h
577 and after defining the compiler macros which are used in it too
578 */
579 #include "wx/chkconf.h"
580
581
582 /*
583 some compilers don't support iostream.h any longer, while some of theme
584 are not updated with <iostream> yet, so override the users setting here
585 in such case.
586 */
587 #if defined(_MSC_VER) && (_MSC_VER >= 1310)
588 # undef wxUSE_IOSTREAMH
589 # define wxUSE_IOSTREAMH 0
590 #elif defined(__DMC__) || defined(__WATCOMC__)
591 # undef wxUSE_IOSTREAMH
592 # define wxUSE_IOSTREAMH 1
593 #elif defined(__MINGW32__)
594 # undef wxUSE_IOSTREAMH
595 # define wxUSE_IOSTREAMH 0
596 #endif /* compilers with/without iostream.h */
597
598 /*
599 old C++ headers (like <iostream.h>) declare classes in the global namespace
600 while the new, standard ones (like <iostream>) do it in std:: namespace,
601 unless it's an old gcc version.
602
603 using this macro allows constuctions like "wxSTD iostream" to work in
604 either case
605 */
606 #if !wxUSE_IOSTREAMH && (!defined(__GNUC__) || ( __GNUC__ > 2 ) || (__GNUC__ == 2 && __GNUC_MINOR__ >= 95))
607 # define wxSTD std::
608 #else
609 # define wxSTD
610 #endif
611
612 /* On OpenVMS with the most recent HP C++ compiler some function (i.e. wscanf)
613 * are only available in the std-namespace. (BUG???)
614 */
615 #if defined( __VMS ) && (__DECCXX_VER >= 70100000) && !defined(__STD_CFRONT) && !defined( __NONAMESPACE_STD )
616 # define wxVMS_USE_STD std::
617 #else
618 # define wxVMS_USE_STD
619 #endif
620
621 /* Choose which method we will use for updating menus
622 * - in OnIdle, or when we receive a wxEVT_MENU_OPEN event.
623 * Presently, only Windows and GTK+ support wxEVT_MENU_OPEN.
624 */
625 #ifndef wxUSE_IDLEMENUUPDATES
626 # if (defined(__WXMSW__) || defined(__WXGTK__)) && !defined(__WXUNIVERSAL__)
627 # define wxUSE_IDLEMENUUPDATES 0
628 # else
629 # define wxUSE_IDLEMENUUPDATES 1
630 # endif
631 #endif
632
633 /*
634 * Define symbols that are not yet in
635 * configure or possibly some setup.h files.
636 * They will need to be added.
637 */
638
639 #ifndef wxUSE_FILECONFIG
640 # if wxUSE_CONFIG
641 # define wxUSE_FILECONFIG 1
642 # else
643 # define wxUSE_FILECONFIG 0
644 # endif
645 #endif
646
647 #ifndef wxUSE_HOTKEY
648 # define wxUSE_HOTKEY 0
649 #endif
650
651 #if !defined(wxUSE_WXDIB) && defined(__WXMSW__)
652 # define wxUSE_WXDIB 1
653 #endif
654
655 /*
656 We need AvailabilityMacros.h for ifdefing out things that don't exist on
657 OSX 10.2 and lower
658 FIXME: We need a better way to detect for 10.3 then including a system header
659 */
660 #ifdef __DARWIN__
661 #include <AvailabilityMacros.h>
662 #endif
663
664 #endif /* _WX_PLATFORM_H_ */