3 * Purpose: Declarations common to wx char/wchar_t usage (wide chars)
4 * Author: Joel Farley, Ove Kåven
5 * Modified by: Vadim Zeitlin, Robert Roebling, Ron Lee
8 * Copyright: (c) 1998-2002 Joel Farley, Ove Kåven, Robert Roebling, Ron Lee
9 * Licence: wxWindows licence
12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
17 /* defs.h indirectly includes this file, so don't include it here */
18 #include "wx/platform.h"
19 #include "wx/dlimpexp.h"
21 #if defined(HAVE_STRTOK_R) && defined(__DARWIN__) && defined(_MSL_USING_MW_C_HEADERS) && _MSL_USING_MW_C_HEADERS
22 char *strtok_r(char *, const char *, char **);
25 /* check whether we have wchar_t and which size it is if we do */
26 #if !defined(wxUSE_WCHAR_T)
28 #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || defined(__DARWIN__)
29 #define wxUSE_WCHAR_T 1
31 #define wxUSE_WCHAR_T 0
33 #elif defined(__GNUWIN32__) && !defined(__MINGW32__)
34 #define wxUSE_WCHAR_T 0
35 #elif defined(__WATCOMC__)
36 #define wxUSE_WCHAR_T 0
37 #elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
38 #define wxUSE_WCHAR_T 0
40 /* add additional compiler checks if this fails */
41 #define wxUSE_WCHAR_T 1
43 #endif /* !defined(wxUSE_WCHAR_T) */
45 /* Unicode support requires wchar_t */
46 #if wxUSE_UNICODE && !wxUSE_WCHAR_T
47 #error "wchar_t must be available in Unicode build"
51 Standard headers we need here.
53 NB: don't include any wxWidgets headers here because almost all of them include
57 /* Required for wxPrintf() etc */
60 /* Almost all compiler have strdup(), but not quite all: CodeWarrior under Mac */
61 /* and VC++ for Windows CE don't provide it */
62 #if defined(__VISUALC__) && __VISUALC__ >= 1400
63 #define wxStrdupA _strdup
64 #elif !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
65 /* use #define, not inline wrapper, as it is tested with #ifndef below */
66 #define wxStrdupA strdup
70 non Unix compilers which do have wchar.h (but not tchar.h which is included
71 below and which includes wchar.h anyhow).
73 Actually MinGW has tchar.h, but it does not include wchar.h
75 #if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__) || defined(__WATCOMC__)
80 #if defined(__MWERKS__) && !defined(__MACH__)
88 /* the current (as of Nov 2002) version of cygwin has a bug in its */
89 /* wchar.h -- there is no extern "C" around the declarations in it and */
90 /* this results in linking errors later; also, at least on some */
91 /* Cygwin versions, wchar.h requires sys/types.h */
93 #include <sys/types.h>
101 #if defined(__CYGWIN__) && defined(__cplusplus)
103 #endif /* Cygwin and C++ */
105 #elif defined(HAVE_WCSTR_H)
106 /* old compilers have relevant declarations here */
108 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
109 /* include stdlib.h for wchar_t */
111 #endif /* HAVE_WCHAR_H */
112 #endif /* wxUSE_WCHAR_T */
114 /* ---------------------------------------------------------------------------- */
115 /* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
116 /* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
117 /* the function mapping _tfoo() -> foo() or wfoo() */
118 /* ---------------------------------------------------------------------------- */
120 /* VC++ and BC++ starting with 5.2 have TCHAR support */
122 #define wxHAVE_TCHAR_SUPPORT
123 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
124 #define wxHAVE_TCHAR_SUPPORT
126 #elif defined(__WATCOMC__)
127 #define wxHAVE_TCHAR_SUPPORT
128 #elif defined(__DMC__)
129 #define wxHAVE_TCHAR_SUPPORT
130 #elif defined(__WXPALMOS__)
132 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 )
133 #define wxHAVE_TCHAR_SUPPORT
137 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
138 /* VZ: the old VisualAge definitions were completely wrong and had no */
139 /* chance at all to work in Unicode build anyhow so let's pretend that */
140 /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
141 /* "0 &&" above) until someone really has time to delve into Unicode */
142 /* issues under OS/2 */
144 /* VisualAge 4.0+ supports TCHAR */
145 #define wxHAVE_TCHAR_SUPPORT
146 #endif /* compilers with (good) TCHAR support */
148 #if defined(__MWERKS__)
149 /* Metrowerks only has wide char support for OS X >= 10.3 */
150 #if !defined(__DARWIN__) || \
151 (MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_3)
152 #define wxHAVE_MWERKS_UNICODE
155 #ifdef wxHAVE_MWERKS_UNICODE
158 #endif /* __MWERKS__ */
160 #ifdef wxHAVE_TCHAR_SUPPORT
161 /* get TCHAR definition if we've got it */
164 /* we surely do have wchar_t if we have TCHAR */
165 #ifndef wxUSE_WCHAR_T
166 #define wxUSE_WCHAR_T 1
167 #endif /* !defined(wxUSE_WCHAR_T) */
169 /* and we also do have wcslen() */
173 #endif /* wxHAVE_TCHAR_SUPPORT */
175 /* ---------------------------------------------------------------------------- */
176 /* define wxChar type */
177 /* ---------------------------------------------------------------------------- */
179 /* TODO: define wxCharInt to be equal to either int or wint_t? */
183 typedef signed char wxSChar
;
184 typedef unsigned char wxUChar
;
186 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
187 /* signed/unsigned version of it which (a) makes sense to me (unlike */
188 /* char wchar_t is always unsigned) and (b) was how the previous */
189 /* definitions worked so keep it like this */
191 /* Sun's SunPro compiler supports the wchar_t type and wide character */
192 /* functions, but does not define __WCHAR_TYPE__. Define it here to */
193 /* allow unicode enabled builds. */
194 #if defined(__SUNPRO_CC) || defined(__SUNPRO_C)
195 #define __WCHAR_TYPE__ wxchar_t
198 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
200 #if !defined(__WCHAR_TYPE__) || \
201 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
203 typedef wchar_t wxChar
;
204 typedef wchar_t wxSChar
;
205 typedef wchar_t wxUChar
;
206 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
207 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
208 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
209 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
210 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
211 /* have to define wxChar conditionally depending on detected */
212 /* compiler & compiler version. */
213 /* with old definition of wxChar. */
214 typedef __WCHAR_TYPE__ wxChar
;
215 typedef __WCHAR_TYPE__ wxSChar
;
216 typedef __WCHAR_TYPE__ wxUChar
;
217 #endif /* __WCHAR_TYPE__ */
218 #endif /* ASCII/Unicode */
220 /* ---------------------------------------------------------------------------- */
221 /* define _T() and related macros */
222 /* ---------------------------------------------------------------------------- */
224 /* BSD systems define _T() to be something different in ctype.h, override it */
225 #if defined(__FreeBSD__) || defined(__DARWIN__)
230 /* could already be defined by tchar.h (it's quasi standard) */
235 /* use wxCONCAT_HELPER so that x could be expanded if it's a macro */
236 #define _T(x) wxCONCAT_HELPER(L, x)
237 #endif /* ASCII/Unicode */
238 #endif /* !defined(_T) */
240 /* although global macros with such names are normally bad, we want to have */
241 /* another name for _T() which should be used to avoid confusion between _T() */
242 /* and _() in wxWidgets sources */
245 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
247 #define __XFILE__(x) wxT(x)
248 #define __TFILE__ __XFILE__(__FILE__)
252 #define __XDATE__(x) wxT(x)
253 #define __TDATE__ __XDATE__(__DATE__)
257 #define __XTIME__(x) wxT(x)
258 #define __TTIME__ __XTIME__(__TIME__)
262 define wxFoo() function for each standard foo() function whose signature
263 (exceptionally including the return type) includes any mention of char:
264 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
265 the same signature but with char replaced by wxChar which allows us to use
266 it in Unicode build as well
269 #ifdef wxHAVE_TCHAR_SUPPORT
272 #if defined(__WATCOMC__) && defined(UNICODE)
273 #define WXWCHAR_T_CAST(c) (wint_t)(c)
275 #define WXWCHAR_T_CAST(c) c
278 /* ctype.h functions */
279 #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
280 #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
281 #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
282 #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
283 #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
284 #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
285 #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
286 #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
287 #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
288 #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
289 #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
292 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
293 signed chars < 0, so "fix" it here.
295 #define wxTolower(c) _totlower((wxUChar)(c))
296 #define wxToupper(c) _totupper((wxUChar)(c))
298 /* locale.h functons */
299 #define wxSetlocale _tsetlocale
301 /* string.h functions */
302 #define wxStrcat _tcscat
303 #define wxStrchr _tcschr
304 #define wxStrcmp _tcscmp
305 #define wxStrcoll _tcscoll
306 #define wxStrcpy _tcscpy
307 #define wxStrcspn _tcscspn
308 #define wxStrdupW _wcsdup /* notice the 'W'! */
309 #define wxStrftime _tcsftime
310 #define wxStricmp _tcsicmp
311 #define wxStrnicmp _tcsnicmp
312 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
313 #define wxStrncat _tcsncat
314 #define wxStrncmp _tcsncmp
315 #define wxStrncpy _tcsncpy
316 #define wxStrpbrk _tcspbrk
317 #define wxStrrchr _tcsrchr
318 #define wxStrspn _tcsspn
319 #define wxStrstr _tcsstr
320 #define wxStrtod _tcstod
321 #define wxStrtol _tcstol
322 #define wxStrtoul _tcstoul
323 #define wxStrxfrm _tcsxfrm
325 /* stdio.h functions */
326 #define wxFgetc _fgettc
327 #define wxFgetchar _fgettchar
328 #define wxFgets _fgetts
329 #if wxUSE_UNICODE_MSLU
330 #define wxFopen wxMSLU__tfopen
332 #define wxFopen _tfopen
334 #define wxFputc _fputtc
335 #define wxFputchar _fputtchar
336 #define wxFprintf _ftprintf
337 #define wxFputs _fputts
338 #define wxFreopen _tfreopen
339 #define wxFscanf _ftscanf
340 #define wxGetc _gettc
341 #define wxGetchar _gettchar
342 #define wxGets _getts
343 #define wxPerror _tperror
344 #define wxPrintf _tprintf
345 #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
346 #define wxPutchar _puttchar
347 #define wxPuts _putts
348 #define wxScanf _tscanf
351 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
352 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
354 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
355 #define wxSprintf sprintf
358 #define wxSprintf _stprintf
361 #define wxSscanf _stscanf
362 #define wxTmpnam _ttmpnam
363 #define wxUngetc _tungetc
364 #define wxVfprintf _vftprintf
365 #define wxVprintf _vtprintf
366 #define wxVsscanf _vstscanf
367 #define wxVsprintf _vstprintf
369 /* special case: not all TCHAR-aware compilers have those */
370 #if defined(__VISUALC__) || \
371 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
372 #define wxVsnprintf_ _vsntprintf
373 #define wxSnprintf_ _sntprintf
376 /* special case: these functions are missing under Win9x with Unicows so we */
377 /* have to implement them ourselves */
378 #if wxUSE_UNICODE_MSLU
379 #define wxRemove wxMSLU__tremove
380 #define wxRename wxMSLU__trename
383 /* carefully: wxRemove() must return 0 on success while DeleteFile()
384 returns 0 on error, so don't just define one as the other */
385 int wxRemove(const wxChar
*path
);
387 #define wxRemove _tremove
388 #define wxRename _trename
392 /* stdlib.h functions */
395 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
396 /* there are no env vars at all under CE, so no _tgetenv neither */
398 /* can't define as inline function as this is a C file... */
399 #define wxGetenv(name) ((wxChar *)NULL)
401 #define wxGetenv _tgetenv
403 #define wxSystem _tsystem
405 /* time.h functions */
406 #define wxAsctime _tasctime
407 #define wxCtime _tctime
409 #define wxMbstowcs mbstowcs
410 #define wxWcstombs wcstombs
411 #else /* !TCHAR-aware compilers */
413 There are 2 unrelated problems with these functions under Mac:
414 a) Metrowerks MSL CRT implements them strictly in C99 sense and
415 doesn't support (very common) extension of allowing to call
416 mbstowcs(NULL, ...) which makes it pretty useless as you can't
417 know the size of the needed buffer
418 b) OS X <= 10.2 declares and even defined these functions but
419 doesn't really implement them -- they always return an error
421 So use our own replacements in both cases.
423 #if defined(__MWERKS__) && defined(__MSL__)
424 #define wxNEED_WX_MBSTOWCS
428 #if MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2
429 #define wxNEED_WX_MBSTOWCS
433 #ifdef wxNEED_WX_MBSTOWCS
434 /* even though they are defined and "implemented", they are bad and just
435 stubs so we need our own - we need these even in ANSI builds!! */
436 WXDLLIMPEXP_BASE
size_t wxMbstowcs (wchar_t *, const char *, size_t);
437 WXDLLIMPEXP_BASE
size_t wxWcstombs (char *, const wchar_t *, size_t);
439 #define wxMbstowcs mbstowcs
440 #define wxWcstombs wcstombs
444 The system C library on Mac OS X 10.2 and below does not support
445 unicode: in other words all wide-character functions such as towupper et
446 al. do simply not exist so we need to provide our own in that context,
447 except for the wchar_t definition/typedef itself.
449 We need to do this for both project builder and CodeWarrior as
450 the latter uses the system C library in Mach builds for wide character
451 support, which as mentioned does not exist on 10.2 and below.
453 #if wxUSE_UNICODE && \
454 defined(__DARWIN__) && \
455 ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
456 /* we need everything! */
457 #define wxNEED_WX_STRING_H
458 #define wxNEED_WX_CTYPE_H
460 #define wxFgetchar(c) wxFgetc(c, stdin)
461 #define wxFputc wxPutc
462 #define wxFputchar(c) wxPutc(c, stdout)
463 #define wxGetc wxFgetc
464 #define wxGetchar(c) wxFgetc(c, stdin)
471 #define wxNEED_UNGETC
477 int wxFputs(const wxChar
*ch
, FILE *stream
);
478 int wxPuts(const wxChar
*ws
);
479 int wxPutc(wxChar ch
, FILE *stream
);
484 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
489 #define wxPutchar(wch) wxPutc(wch, stdout)
491 #define wxNEED_PRINTF_CONVERSION
492 #define wxNEED_WX_STDIO_H
493 #define wxNEED_WX_STDLIB_H
494 #define wxNEED_WX_TIME_H
499 /* this is probably glibc-specific */
500 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
501 /* ctype.h functions (wctype.h) */
502 #define wxIsalnum iswalnum
503 #define wxIsalpha iswalpha
504 #define wxIscntrl iswcntrl
505 #define wxIsdigit iswdigit
506 #define wxIsgraph iswgraph
507 #define wxIslower iswlower
508 #define wxIsprint iswprint
509 #define wxIspunct iswpunct
510 #define wxIsspace iswspace
511 #define wxIsupper iswupper
512 #define wxIsxdigit iswxdigit
514 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
515 /* /usr/include/wctype.h incorrectly declares translations */
516 /* tables which provokes tons of compile-time warnings -- try */
517 /* to correct this */
518 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
519 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
520 #else /* !glibc 2.0 */
521 #define wxTolower towlower
522 #define wxToupper towupper
523 #endif /* gcc/!gcc */
525 /* string.h functions (wchar.h) */
526 #define wxStrcat wcscat
527 #define wxStrchr wcschr
528 #define wxStrcmp wcscmp
529 #define wxStrcoll wcscoll
530 #define wxStrcpy wcscpy
531 #define wxStrcspn wcscspn
532 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
533 #define wxStrncat wcsncat
534 #define wxStrncmp wcsncmp
535 #define wxStrncpy wcsncpy
536 #define wxStrpbrk wcspbrk
537 #define wxStrrchr wcsrchr
538 #define wxStrspn wcsspn
539 #define wxStrstr wcsstr
540 #define wxStrtod wcstod
541 #define wxStrtol wcstol
542 #define wxStrtoul wcstoul
543 #define wxStrxfrm wcsxfrm
545 #define wxFgetc fgetwc
546 #define wxFgetchar fgetwchar
547 #define wxFgets fgetws
548 #define wxFputc fputwc
549 #define wxFputchar fputwchar
551 #define wxGetchar getwchar
553 #define wxUngetc ungetwc
556 #define wxFputs fputws
560 int wxFputs(const wxChar
*ch
, FILE *stream
);
568 int wxPutc(wxChar ch
, FILE *stream
);
572 #define wxPutchar wputchar
574 #define wxPutchar(wch) wxPutc(wch, stdout)
581 int wxPuts(const wxChar
*ws
);
584 /* we need %s to %ls conversion for printf and scanf etc */
585 #define wxNEED_PRINTF_CONVERSION
587 /* glibc doesn't have wide char equivalents of the other stuff so */
588 /* use our own versions */
589 #define wxNEED_WX_STDIO_H
590 #define wxNEED_WX_STDLIB_H
591 #define wxNEED_WX_TIME_H
592 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
593 /* ctype.h functions (wctype.h) */
594 #define wxIsalnum iswalnum
595 #define wxIsalpha iswalpha
596 #define wxIscntrl iswcntrl
597 #define wxIsdigit iswdigit
598 #define wxIsgraph iswgraph
599 #define wxIslower iswlower
600 #define wxIsprint iswprint
601 #define wxIspunct iswpunct
602 #define wxIsspace iswspace
603 #define wxIsupper iswupper
604 #define wxIsxdigit iswxdigit
605 #define wxTolower towlower
606 #define wxToupper towupper
608 /* string.h functions (wchar.h) */
609 #define wxStrcat wcscat
610 #define wxStrchr wcschr
611 #define wxStrcmp wcscmp
612 #define wxStrcoll wcscoll
613 #define wxStrcpy wcscpy
614 #define wxStrcspn wcscspn
615 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
616 #define wxStrncat wcsncat
617 #define wxStrncmp wcsncmp
618 #define wxStrncpy wcsncpy
619 #define wxStrpbrk wcspbrk
620 #define wxStrrchr wcsrchr
621 #define wxStrspn wcsspn
622 #define wxStrstr wcsstr
623 #define wxStrtod wcstod
624 #define wxStrtol wcstol
625 #define wxStrtoul wcstoul
626 #define wxStrxfrm wcsxfrm
628 #define wxFgetc fgetwc
629 #define wxFgetchar fgetwchar
630 #define wxFgets fgetws
631 #define wxFputc fputwc
632 #define wxFputchar fputwchar
634 #define wxGetchar getwchar
636 #define wxUngetc ungetwc
638 #define wxNEED_PRINTF_CONVERSION
641 #define wxPutchar putwchar
642 #define wxFputs fputws
644 /* stdio.h functions */
646 #define wxNEED_WX_STDIO_H
648 /* stdlib.h functions */
650 #define wxNEED_WX_STDLIB_H
655 #define wxGetenv(a) ((wxChar*)NULL)
656 #define wxSystem(a) ((int)NULL)
658 /* time.h functions */
659 #define wxAsctime wasciitime
660 #define wxCtime wctime
661 /* #define wxStrftime wcsftime */
663 #define wxNEED_WX_TIME_H
664 #else /* !metrowerks for apple */
665 #error "Please define wide character functions for your environment"
671 /* ctype.h functions */
672 #define wxIsalnum isalnum
673 #define wxIsalpha isalpha
674 #define wxIscntrl iscntrl
675 #define wxIsdigit isdigit
676 #define wxIsgraph isgraph
677 #define wxIslower islower
678 #define wxIsprint isprint
679 #define wxIspunct ispunct
680 #define wxIsspace isspace
681 #define wxIsupper isupper
682 #define wxIsxdigit isxdigit
683 #define wxTolower tolower
684 #define wxToupper toupper
686 /* locale.h functons */
687 #define wxSetlocale setlocale
689 /* string.h functions */
690 #define wxStrcat strcat
691 #define wxStrchr strchr
692 #define wxStrcmp strcmp
693 #define wxStrcoll strcoll
694 #define wxStrcpy strcpy
695 #define wxStrcspn strcspn
697 /* wxStricmp and wxStrnicmp are defined below */
698 #define wxStrlen_ strlen /* used in wxStrlen inline function */
699 #define wxStrncat strncat
700 #define wxStrncmp strncmp
701 #define wxStrncpy strncpy
702 #define wxStrpbrk strpbrk
703 #define wxStrrchr strrchr
704 #define wxStrspn strspn
705 #define wxStrstr strstr
706 #define wxStrtod strtod
708 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
710 #define wxStrtol strtol
711 #define wxStrtoul strtoul
712 #define wxStrxfrm strxfrm
714 /* stdio.h functions */
715 #define wxFopen fopen
716 #define wxFreopen freopen
717 #define wxRemove remove
718 #define wxRename rename
720 #define wxPerror perror
721 #define wxTmpnam tmpnam
723 #define wxFgetc fgetc
724 #define wxFgetchar fgetchar
725 #define wxFgets fgets
726 #define wxFputc fputc
727 #define wxFputs fputs
728 #define wxFputchar fputchar
729 #define wxFprintf fprintf
730 #define wxFscanf fscanf
732 #define wxGetchar getchar
734 #define wxPrintf printf
736 #define wxPutchar putchar
738 #define wxScanf scanf
739 #define wxSprintf sprintf
740 #define wxSscanf sscanf
741 #define wxUngetc ungetc
742 #define wxVfprintf vfprintf
743 #define wxVprintf vprintf
744 #define wxVsscanf vsscanf
745 #define wxVsprintf vsprintf
747 /* stdlib.h functions */
751 #define wxGetenv getenv
752 #define wxSystem system
754 /* time.h functions */
755 #define wxAsctime asctime
756 #define wxCtime ctime
757 #define wxStrftime strftime
758 #endif /* Unicode/ASCII */
759 #endif /* TCHAR-aware compilers/the others */
762 various special cases
765 /* define wxStricmp and wxStrnicmp for various compilers */
767 /* note that in Unicode mode we definitely are going to need our own version */
768 #if !defined(wxStricmp) && !wxUSE_UNICODE
769 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
770 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
771 defined(__EMX__) || defined(__DJGPP__)
772 #define wxStricmp stricmp
773 #define wxStrnicmp strnicmp
774 #elif defined(__WXPALMOS__)
775 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
776 * quick hack should do until one can be written.
778 #define wxStricmp StrCaselessCompare
779 #define wxStrnicmp strnicmp
780 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
781 (defined(__MWERKS__) && defined(__INTEL__))
782 #define wxStricmp _stricmp
783 #define wxStrnicmp _strnicmp
784 #elif defined(__UNIX__) || defined(__GNUWIN32__)
785 #define wxStricmp strcasecmp
786 #define wxStrnicmp strncasecmp
787 /* #else -- use wxWidgets implementation */
789 #endif /* !defined(wxStricmp) */
791 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
792 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
793 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
796 #define wxWcslen wcslen
798 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
800 #endif /* wxUSE_WCHAR_T */
803 /* checks whether the passed in pointer is NULL and if the string is empty */
804 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
806 /* safe version of strlen() (returns 0 if passed NULL pointer) */
807 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
811 each of strdup() and wcsdup() may or may not be available but we need both
812 of them anyhow for wx/buffer.h so we define the missing one(s) in
813 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
814 defined -- if this is somehow not the case in some situations, please
815 correct that and not the lines here
818 #define wxStrdup wxStrdupW
820 #define wxStrdup wxStrdupA
824 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
827 /* printf() family saga */
830 For some systems [v]snprintf() exists in the system libraries but not in the
831 headers, so we need to declare it ourselves to be able to use it.
833 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
839 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
840 #endif /* !HAVE_VSNPRINTF_DECL */
842 #if defined(HAVE_SNPRINTF) && !defined(HAVE_SNPRINTF_DECL)
848 int snprintf(char *str
, size_t size
, const char *format
, ...);
849 #endif /* !HAVE_SNPRINTF_DECL */
851 /* Wrapper for vsnprintf if it's 3rd parameter is non-const. Note: the
852 * same isn't done for snprintf below, the builtin wxSnprintf_ is used
853 * instead since it's already a simple wrapper */
854 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
855 inline int wx_fixed_vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
)
857 return vsnprintf(str
, size
, (char*)format
, ap
);
862 First of all, we always want to define safe snprintf() function to be used
863 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
864 which we really need...), otherwise we implement it using our own printf()
867 We define function with a trailing underscore here because the real one is a
868 wrapper around it as explained below
872 #ifdef wxHAVE_MWERKS_UNICODE
873 #define HAVE_WCSRTOMBS 1
874 #define HAVE_VSWPRINTF 1
875 #endif /* Metrowerks with Unicode support */
876 #if defined(__WATCOMC__)
877 #define wxVsnprintf_ _vsnwprintf
878 #define wxSnprintf_ _snwprintf
880 #if defined(HAVE__VSNWPRINTF)
881 #define wxVsnprintf_ _vsnwprintf
882 /* MinGW?MSVCRT has the wrong vswprintf */
883 /* Mac OS X has a somehow buggy vswprintf */
884 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__) && !defined(__DARWIN__)
885 #define wxVsnprintf_ vswprintf
888 /* all versions of CodeWarrior supported by wxWidgets apparently have */
889 /* both snprintf() and vsnprintf() */
890 #if defined(HAVE_SNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
891 #ifndef HAVE_BROKEN_SNPRINTF_DECL
892 #define wxSnprintf_ snprintf
895 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
896 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
897 #define wxVsnprintf_ wx_fixed_vsnprintf
899 #define wxVsnprintf_ vsnprintf
903 #endif /* wxVsnprintf_ not defined yet */
906 /* no [v]snprintf(), cook our own */
907 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
908 ...) ATTRIBUTE_PRINTF_3
;
911 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
916 In Unicode mode we need to have all standard functions such as wprintf() and
917 so on but not all systems have them so use our own implementations in this
920 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
921 #define wxNEED_WPRINTF
925 More Unicode complications: although both ANSI C and C++ define a number of
926 wide character functions such as wprintf(), not all environments have them.
927 Worse, those which do have different behaviours: under Windows, %s format
928 specifier changes its meaning in Unicode build and expects a Unicode string
929 while under Unix/POSIX it still means an ASCII string even for wprintf() and
930 %ls has to be used for wide strings.
932 We choose to always emulate Windows behaviour as more useful for us so even
933 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
937 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
939 we need to implement all wide character printf and scanf functions
940 either because we don't have them at all or because they don't have the
944 #include <stdio.h> /* for FILE */
946 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
947 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
948 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
949 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
950 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
951 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
952 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
953 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
954 int wxVprintf( const wxChar
*format
, va_list ap
);
955 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
956 #endif /* wxNEED_PRINTF_CONVERSION */
958 /* these 2 can be simply mapped to the versions with underscore at the end */
959 /* if we don't have to do the conversion */
961 However, if we don't have any vswprintf() at all we don't need to redefine
962 anything as our own wxVsnprintf_() already behaves as needed.
964 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
965 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
966 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
968 #define wxSnprintf wxSnprintf_
969 #define wxVsnprintf wxVsnprintf_
973 various functions which might not be available in libc and for which we
974 provide our own replacements in wxchar.cpp
977 /* ctype.h functions */
979 /* RN: Used only under OSX <= 10.2 currently */
980 #ifdef wxNEED_WX_CTYPE_H
981 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
982 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
983 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
984 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
985 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
986 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
987 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
988 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
989 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
990 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
991 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
992 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
993 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
994 #endif /* wxNEED_WX_CTYPE_H */
996 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
997 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
998 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
1000 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
1004 a few compilers don't have the (non standard but common) isascii function,
1005 define it ourselves for them
1008 #if defined(__MWERKS__)
1009 #define wxNEED_ISASCII
1010 #elif defined(_WIN32_WCE)
1011 #if _WIN32_WCE <= 211
1012 #define wxNEED_ISASCII
1015 #endif /* isascii */
1017 #ifdef wxNEED_ISASCII
1018 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
1022 #if _WIN32_WCE <= 211
1023 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
1025 #endif /* _WIN32_WCE */
1028 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
1029 initial versions of this header -- now it is too late to remove it so
1030 although we fixed the function/macro name above, still provide the
1031 backwards-compatible synonym.
1033 #define wxIsctrl wxIscntrl
1035 /* string.h functions */
1037 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
1038 #define wxNEED_STRDUP
1039 #elif defined(__WXWINCE__)
1040 #if _WIN32_WCE <= 211
1041 #define wxNEED_STRDUP
1046 #ifdef wxNEED_STRDUP
1047 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
1050 /* RN: Used only under OSX <= 10.2 currently
1051 The __cplusplus ifdefs are messy, but they are required to build
1052 the regex library, since c does not support function overloading
1054 #ifdef wxNEED_WX_STRING_H
1058 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
1059 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
1060 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
1061 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
1062 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
1063 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
1064 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
1065 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
1066 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
1067 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
1068 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
1069 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
1070 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
1075 /* These functions use C++, so we can't c extern them */
1076 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
1077 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1078 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1079 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
1081 /* inlined versions */
1083 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
1084 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
1085 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
1086 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
1087 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
1088 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
1089 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
1090 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
1093 #endif /* wxNEED_WX_STRING_H */
1096 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
1100 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
1104 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
1108 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1112 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1117 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1118 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1122 /* stdio.h functions */
1123 #ifdef wxNEED_WX_STDIO_H
1125 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1126 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1127 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1128 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1130 /* *printf() family is handled separately */
1131 #endif /* wxNEED_WX_STDIO_H */
1134 /* stdlib.h functions */
1136 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1139 #ifdef wxNEED_WX_STDLIB_H
1140 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1141 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1142 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1143 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1147 /* time.h functions */
1148 #ifdef wxNEED_WX_TIME_H
1149 #if defined(__MWERKS__) && defined(macintosh)
1152 /*silent gabby compilers*/
1154 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1155 const wxChar
*fmt
, const struct tm
*tm
);
1156 #endif /* wxNEED_WX_TIME_H */
1160 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1164 /* missing functions in some WinCE versions */
1166 #if (_WIN32_WCE < 300)
1167 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1169 #endif /* _WIN32_WCE */
1171 /* multibyte to wide char conversion functions and macros */
1174 /* multibyte<->widechar conversion */
1175 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1176 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1179 #define wxMB2WX wxMB2WC
1180 #define wxWX2MB wxWC2MB
1181 #define wxWC2WX wxStrncpy
1182 #define wxWX2WC wxStrncpy
1184 #define wxMB2WX wxStrncpy
1185 #define wxWX2MB wxStrncpy
1186 #define wxWC2WX wxWC2MB
1187 #define wxWX2WC wxMB2WC
1189 #else /* !wxUSE_UNICODE */
1190 /* Why is this here?
1192 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1193 #define wxMB2WC wxStrncpy
1194 #define wxWC2MB wxStrncpy
1195 #define wxMB2WX wxStrncpy
1196 #define wxWX2MB wxStrncpy
1197 #define wxWC2WX wxWC2MB
1198 #define wxWX2WC wxMB2WC
1202 RN: The following are not normal versions of memcpy et al., rather
1203 these are either char or widechar versions depending on
1204 if unicode is used or not.
1210 // RN: We could do the usual tricky compiler detection here,
1211 // and use their variant (such as wmemchr, etc.). The problem
1212 // is that these functions are quite rare, even though they are
1213 // part of the current POSIX standard. In addition, most compilers
1214 // (including even MSC) inline them just like we do right in their
1218 #include <string.h> //for mem funcs
1220 //implement our own wmem variants
1221 inline wxChar
* wxTmemchr(const wxChar
* s
, wxChar c
, size_t l
)
1223 for(;l
&& *s
!= c
;--l
, ++s
) {}
1230 inline int wxTmemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1232 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1235 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1240 inline wxChar
* wxTmemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1242 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1245 inline wxChar
* wxTmemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1247 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1250 inline wxChar
* wxTmemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1252 wxChar
* szRet
= szOut
;
1260 #else /* !wxUSE_UNICODE */
1261 # define wxTmemchr memchr
1262 # define wxTmemcmp memcmp
1263 # define wxTmemcpy memcpy
1264 # define wxTmemmove memmove
1265 # define wxTmemset memset
1266 #endif /* wxUSE_UNICODE/!wxUSE_UNICODE */
1268 #endif /*__cplusplus*/
1271 #endif /* _WX_WXCHAR_H_ */