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 #include "wx/defs.h" /* for wxUSE_UNICODE */
19 #if defined(HAVE_STRTOK_R) && defined(__DARWIN__) && defined(_MSL_USING_MW_C_HEADERS) && _MSL_USING_MW_C_HEADERS
20 char *strtok_r(char *, const char *, char **);
23 /* check whether we have wchar_t and which size it is if we do */
24 #if !defined(wxUSE_WCHAR_T)
26 #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || defined(__DARWIN__)
27 #define wxUSE_WCHAR_T 1
29 #define wxUSE_WCHAR_T 0
31 #elif defined(__GNUWIN32__) && !defined(__MINGW32__)
32 #define wxUSE_WCHAR_T 0
33 #elif defined(__WATCOMC__)
34 #define wxUSE_WCHAR_T 0
35 #elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
36 #define wxUSE_WCHAR_T 0
38 /* add additional compiler checks if this fails */
39 #define wxUSE_WCHAR_T 1
41 #endif /* !defined(wxUSE_WCHAR_T) */
43 /* Unicode support requires wchar_t */
44 #if wxUSE_UNICODE && !wxUSE_WCHAR_T
45 #error "wchar_t must be available in Unicode build"
49 Standard headers we need here.
51 NB: don't include any wxWidgets headers here because almost of them include
55 /* Required for wxPrintf() etc */
58 /* Almost all compiler have strdup(), but not quite all: CodeWarrior under Mac */
59 /* and VC++ for Windows CE don't provide it */
60 #if !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
61 /* use #define, not inline wrapper, as it is tested with #ifndef below */
62 #define wxStrdupA strdup
66 non Unix compilers which do have wchar.h (but not tchar.h which is included
67 below and which includes wchar.h anyhow).
69 Actually MinGW has tchar.h, but it does not include wchar.h
71 #if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__) || defined(__WATCOMC__)
76 #if defined(__MWERKS__) && !defined(__MACH__)
84 /* the current (as of Nov 2002) version of cygwin has a bug in its */
85 /* wchar.h -- there is no extern "C" around the declarations in it and */
86 /* this results in linking errors later; also, at least on some */
87 /* Cygwin versions, wchar.h requires sys/types.h */
89 #include <sys/types.h>
97 #if defined(__CYGWIN__) && defined(__cplusplus)
99 #endif /* Cygwin and C++ */
101 #elif defined(HAVE_WCSTR_H)
102 /* old compilers have relevant declarations here */
104 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
105 /* include stdlib.h for wchar_t */
107 #endif /* HAVE_WCHAR_H */
108 #endif /* wxUSE_WCHAR_T */
110 /* ---------------------------------------------------------------------------- */
111 /* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
112 /* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
113 /* the function mapping _tfoo() -> foo() or wfoo() */
114 /* ---------------------------------------------------------------------------- */
116 /* VC++ and BC++ starting with 5.2 have TCHAR support */
118 #define wxHAVE_TCHAR_SUPPORT
119 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
120 #define wxHAVE_TCHAR_SUPPORT
122 #elif defined(__WATCOMC__)
123 #define wxHAVE_TCHAR_SUPPORT
124 #elif defined(__DMC__)
125 #define wxHAVE_TCHAR_SUPPORT
126 #elif defined(__WXPALMOS__)
128 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 )
129 #define wxHAVE_TCHAR_SUPPORT
133 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
134 /* VZ: the old VisualAge definitions were completely wrong and had no */
135 /* chance at all to work in Unicode build anyhow so let's pretend that */
136 /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
137 /* "0 &&" above) until someone really has time to delve into Unicode */
138 /* issues under OS/2 */
140 /* VisualAge 4.0+ supports TCHAR */
141 #define wxHAVE_TCHAR_SUPPORT
142 #endif /* compilers with (good) TCHAR support */
144 #if defined(__MWERKS__)
145 /* Metrowerks only has wide char support for OS X >= 10.3 */
146 #if !defined(__DARWIN__) || \
147 (MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_3)
148 #define wxHAVE_MWERKS_UNICODE
151 #ifdef wxHAVE_MWERKS_UNICODE
154 #endif /* __MWERKS__ */
156 #ifdef wxHAVE_TCHAR_SUPPORT
157 /* get TCHAR definition if we've got it */
160 /* we surely do have wchar_t if we have TCHAR */
161 #ifndef wxUSE_WCHAR_T
162 #define wxUSE_WCHAR_T 1
163 #endif /* !defined(wxUSE_WCHAR_T) */
165 /* and we also do have wcslen() */
169 #endif /* wxHAVE_TCHAR_SUPPORT */
171 /* ---------------------------------------------------------------------------- */
172 /* define wxChar type */
173 /* ---------------------------------------------------------------------------- */
175 /* TODO: define wxCharInt to be equal to either int or wint_t? */
179 typedef signed char wxSChar
;
180 typedef unsigned char wxUChar
;
182 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
183 /* signed/unsigned version of it which (a) makes sense to me (unlike */
184 /* char wchar_t is always unsigned) and (b) was how the previous */
185 /* definitions worked so keep it like this */
187 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
189 #if !defined(__WCHAR_TYPE__) || \
190 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
192 typedef wchar_t wxChar
;
193 typedef wchar_t wxSChar
;
194 typedef wchar_t wxUChar
;
195 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
196 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
197 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
198 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
199 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
200 /* have to define wxChar conditionally depending on detected */
201 /* compiler & compiler version. */
202 /* with old definition of wxChar. */
203 typedef __WCHAR_TYPE__ wxChar
;
204 typedef __WCHAR_TYPE__ wxSChar
;
205 typedef __WCHAR_TYPE__ wxUChar
;
206 #endif /* __WCHAR_TYPE__ */
207 #endif /* ASCII/Unicode */
209 /* ---------------------------------------------------------------------------- */
210 /* define _T() and related macros */
211 /* ---------------------------------------------------------------------------- */
213 /* BSD systems define _T() to be something different in ctype.h, override it */
214 #if defined(__FreeBSD__) || defined(__DARWIN__)
219 /* could already be defined by tchar.h (it's quasi standard) */
225 #endif /* ASCII/Unicode */
226 #endif /* !defined(_T) */
228 /* although global macros with such names are normally bad, we want to have */
229 /* another name for _T() which should be used to avoid confusion between _T() */
230 /* and _() in wxWidgets sources */
233 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
235 #define __XFILE__(x) wxT(x)
236 #define __TFILE__ __XFILE__(__FILE__)
240 #define __XDATE__(x) wxT(x)
241 #define __TDATE__ __XDATE__(__DATE__)
245 #define __XTIME__(x) wxT(x)
246 #define __TTIME__ __XTIME__(__TIME__)
250 define wxFoo() function for each standard foo() function whose signature
251 (exceptionally including the return type) includes any mention of char:
252 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
253 the same signature but with char replaced by wxChar which allows us to use
254 it in Unicode build as well
257 #ifdef wxHAVE_TCHAR_SUPPORT
260 #if defined(__WATCOMC__) && defined(UNICODE)
261 #define WXWCHAR_T_CAST(c) (wint_t)(c)
263 #define WXWCHAR_T_CAST(c) c
266 /* ctype.h functions */
267 #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
268 #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
269 #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
270 #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
271 #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
272 #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
273 #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
274 #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
275 #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
276 #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
277 #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
280 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
281 signed chars < 0, so "fix" it here.
283 #define wxTolower(c) _totlower((wxUChar)(c))
284 #define wxToupper(c) _totupper((wxUChar)(c))
286 /* locale.h functons */
287 #define wxSetlocale _tsetlocale
289 /* string.h functions */
290 #define wxStrcat _tcscat
291 #define wxStrchr _tcschr
292 #define wxStrcmp _tcscmp
293 #define wxStrcoll _tcscoll
294 #define wxStrcpy _tcscpy
295 #define wxStrcspn _tcscspn
296 #define wxStrdupW _wcsdup /* notice the 'W'! */
297 #define wxStrftime _tcsftime
298 #define wxStricmp _tcsicmp
299 #define wxStrnicmp _tcsnicmp
300 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
301 #define wxStrncat _tcsncat
302 #define wxStrncmp _tcsncmp
303 #define wxStrncpy _tcsncpy
304 #define wxStrpbrk _tcspbrk
305 #define wxStrrchr _tcsrchr
306 #define wxStrspn _tcsspn
307 #define wxStrstr _tcsstr
308 #define wxStrtod _tcstod
309 #define wxStrtol _tcstol
310 #define wxStrtoul _tcstoul
311 #define wxStrxfrm _tcsxfrm
313 /* stdio.h functions */
314 #define wxFgetc _fgettc
315 #define wxFgetchar _fgettchar
316 #define wxFgets _fgetts
317 #if wxUSE_UNICODE_MSLU
318 #define wxFopen wxMSLU__tfopen
320 #define wxFopen _tfopen
322 #define wxFputc _fputtc
323 #define wxFputchar _fputtchar
324 #define wxFprintf _ftprintf
325 #define wxFputs _fputts
326 #define wxFreopen _tfreopen
327 #define wxFscanf _ftscanf
328 #define wxGetc _gettc
329 #define wxGetchar _gettchar
330 #define wxGets _getts
331 #define wxPerror _tperror
332 #define wxPrintf _tprintf
333 #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
334 #define wxPutchar _puttchar
335 #define wxPuts _putts
336 #define wxScanf _tscanf
339 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
340 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
342 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
343 #define wxSprintf sprintf
346 #define wxSprintf _stprintf
349 #define wxSscanf _stscanf
350 #define wxTmpnam _ttmpnam
351 #define wxUngetc _tungetc
352 #define wxVfprintf _vftprintf
353 #define wxVprintf _vtprintf
354 #define wxVsscanf _vstscanf
355 #define wxVsprintf _vstprintf
357 /* special case: not all TCHAR-aware compilers have those */
358 #if defined(__VISUALC__) || \
359 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
360 #define wxVsnprintf_ _vsntprintf
361 #define wxSnprintf_ _sntprintf
364 /* special case: these functions are missing under Win9x with Unicows so we */
365 /* have to implement them ourselves */
366 #if wxUSE_UNICODE_MSLU
367 #define wxRemove wxMSLU__tremove
368 #define wxRename wxMSLU__trename
371 /* carefully: wxRemove() must return 0 on success while DeleteFile()
372 returns 0 on error, so don't just define one as the other */
373 int wxRemove(const wxChar
*path
);
375 #define wxRemove _tremove
376 #define wxRename _trename
380 /* stdlib.h functions */
383 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
384 /* there are no env vars at all under CE, so no _tgetenv neither */
386 /* can't define as inline function as this is a C file... */
387 #define wxGetenv(name) ((wxChar *)NULL)
389 #define wxGetenv _tgetenv
391 #define wxSystem _tsystem
393 /* time.h functions */
394 #define wxAsctime _tasctime
395 #define wxCtime _tctime
397 #define wxMbstowcs mbstowcs
398 #define wxWcstombs wcstombs
399 #else /* !TCHAR-aware compilers */
401 There are 2 unrelated problems with these functions under Mac:
402 a) Metrowerks MSL CRT implements them strictly in C99 sense and
403 doesn't support (very common) extension of allowing to call
404 mbstowcs(NULL, ...) which makes it pretty useless as you can't
405 know the size of the needed buffer
406 b) OS X <= 10.2 declares and even defined these functions but
407 doesn't really implement them -- they always return an error
409 So use our own replacements in both cases.
411 #if defined(__MWERKS__) && defined(__MSL__)
412 #define wxNEED_WX_MBSTOWCS
416 #if MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2
417 #define wxNEED_WX_MBSTOWCS
421 #ifdef wxNEED_WX_MBSTOWCS
422 /* even though they are defined and "implemented", they are bad and just
423 stubs so we need our own - we need these even in ANSI builds!! */
424 WXDLLIMPEXP_BASE
size_t wxMbstowcs (wchar_t *, const char *, size_t);
425 WXDLLIMPEXP_BASE
size_t wxWcstombs (char *, const wchar_t *, size_t);
427 #define wxMbstowcs mbstowcs
428 #define wxWcstombs wcstombs
432 The system C library on Mac OS X 10.2 and below does not support
433 unicode: in other words all wide-character functions such as towupper et
434 al. do simply not exist so we need to provide our own in that context,
435 except for the wchar_t definition/typedef itself.
437 We need to do this for both project builder and CodeWarrior as
438 the latter uses the system C library in Mach builds for wide character
439 support, which as mentioned does not exist on 10.2 and below.
441 #if wxUSE_UNICODE && \
442 defined(__DARWIN__) && \
443 ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
444 /* we need everything! */
445 #define wxNEED_WX_STRING_H
446 #define wxNEED_WX_CTYPE_H
448 #define wxFgetchar(c) wxFgetc(c, stdin)
449 #define wxFputc wxPutc
450 #define wxFputchar(c) wxPutc(c, stdout)
451 #define wxGetc wxFgetc
452 #define wxGetchar(c) wxFgetc(c, stdin)
459 #define wxNEED_UNGETC
465 int wxFputs(const wxChar
*ch
, FILE *stream
);
466 int wxPuts(const wxChar
*ws
);
467 int wxPutc(wxChar ch
, FILE *stream
);
472 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
477 #define wxPutchar(wch) wxPutc(wch, stdout)
479 #define wxNEED_PRINTF_CONVERSION
480 #define wxNEED_WX_STDIO_H
481 #define wxNEED_WX_STDLIB_H
482 #define wxNEED_WX_TIME_H
487 /* this is probably glibc-specific */
488 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
489 /* ctype.h functions (wctype.h) */
490 #define wxIsalnum iswalnum
491 #define wxIsalpha iswalpha
492 #define wxIscntrl iswcntrl
493 #define wxIsdigit iswdigit
494 #define wxIsgraph iswgraph
495 #define wxIslower iswlower
496 #define wxIsprint iswprint
497 #define wxIspunct iswpunct
498 #define wxIsspace iswspace
499 #define wxIsupper iswupper
500 #define wxIsxdigit iswxdigit
502 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
503 /* /usr/include/wctype.h incorrectly declares translations */
504 /* tables which provokes tons of compile-time warnings -- try */
505 /* to correct this */
506 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
507 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
508 #else /* !glibc 2.0 */
509 #define wxTolower towlower
510 #define wxToupper towupper
511 #endif /* gcc/!gcc */
513 /* string.h functions (wchar.h) */
514 #define wxStrcat wcscat
515 #define wxStrchr wcschr
516 #define wxStrcmp wcscmp
517 #define wxStrcoll wcscoll
518 #define wxStrcpy wcscpy
519 #define wxStrcspn wcscspn
520 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
521 #define wxStrncat wcsncat
522 #define wxStrncmp wcsncmp
523 #define wxStrncpy wcsncpy
524 #define wxStrpbrk wcspbrk
525 #define wxStrrchr wcsrchr
526 #define wxStrspn wcsspn
527 #define wxStrstr wcsstr
528 #define wxStrtod wcstod
529 #define wxStrtol wcstol
530 #define wxStrtoul wcstoul
531 #define wxStrxfrm wcsxfrm
533 #define wxFgetc fgetwc
534 #define wxFgetchar fgetwchar
535 #define wxFgets fgetws
536 #define wxFputc fputwc
537 #define wxFputchar fputwchar
539 #define wxGetchar getwchar
541 #define wxUngetc ungetwc
544 #define wxFputs fputws
548 int wxFputs(const wxChar
*ch
, FILE *stream
);
556 int wxPutc(wxChar ch
, FILE *stream
);
560 #define wxPutchar wputchar
562 #define wxPutchar(wch) wxPutc(wch, stdout)
569 int wxPuts(const wxChar
*ws
);
572 /* we need %s to %ls conversion for printf and scanf etc */
573 #define wxNEED_PRINTF_CONVERSION
575 /* glibc doesn't have wide char equivalents of the other stuff so */
576 /* use our own versions */
577 #define wxNEED_WX_STDIO_H
578 #define wxNEED_WX_STDLIB_H
579 #define wxNEED_WX_TIME_H
580 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
581 /* ctype.h functions (wctype.h) */
582 #define wxIsalnum iswalnum
583 #define wxIsalpha iswalpha
584 #define wxIscntrl iswcntrl
585 #define wxIsdigit iswdigit
586 #define wxIsgraph iswgraph
587 #define wxIslower iswlower
588 #define wxIsprint iswprint
589 #define wxIspunct iswpunct
590 #define wxIsspace iswspace
591 #define wxIsupper iswupper
592 #define wxIsxdigit iswxdigit
593 #define wxTolower towlower
594 #define wxToupper towupper
596 /* string.h functions (wchar.h) */
597 #define wxStrcat wcscat
598 #define wxStrchr wcschr
599 #define wxStrcmp wcscmp
600 #define wxStrcoll wcscoll
601 #define wxStrcpy wcscpy
602 #define wxStrcspn wcscspn
603 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
604 #define wxStrncat wcsncat
605 #define wxStrncmp wcsncmp
606 #define wxStrncpy wcsncpy
607 #define wxStrpbrk wcspbrk
608 #define wxStrrchr wcsrchr
609 #define wxStrspn wcsspn
610 #define wxStrstr wcsstr
611 #define wxStrtod wcstod
612 #define wxStrtol wcstol
613 #define wxStrtoul wcstoul
614 #define wxStrxfrm wcsxfrm
616 #define wxFgetc fgetwc
617 #define wxFgetchar fgetwchar
618 #define wxFgets fgetws
619 #define wxFputc fputwc
620 #define wxFputchar fputwchar
622 #define wxGetchar getwchar
624 #define wxUngetc ungetwc
626 #define wxNEED_PRINTF_CONVERSION
629 #define wxPutchar putwchar
630 #define wxFputs fputws
632 /* stdio.h functions */
634 #define wxNEED_WX_STDIO_H
636 /* stdlib.h functions */
638 #define wxNEED_WX_STDLIB_H
643 #define wxGetenv(a) ((wxChar*)NULL)
644 #define wxSystem(a) ((int)NULL)
646 /* time.h functions */
647 #define wxAsctime wasciitime
648 #define wxCtime wctime
649 /* #define wxStrftime wcsftime */
651 #define wxNEED_WX_TIME_H
652 #else /* !metrowerks for apple */
653 #error "Please define wide character functions for your environment"
659 /* ctype.h functions */
660 #define wxIsalnum isalnum
661 #define wxIsalpha isalpha
662 #define wxIscntrl iscntrl
663 #define wxIsdigit isdigit
664 #define wxIsgraph isgraph
665 #define wxIslower islower
666 #define wxIsprint isprint
667 #define wxIspunct ispunct
668 #define wxIsspace isspace
669 #define wxIsupper isupper
670 #define wxIsxdigit isxdigit
671 #define wxTolower tolower
672 #define wxToupper toupper
674 /* locale.h functons */
675 #define wxSetlocale setlocale
677 /* string.h functions */
678 #define wxStrcat strcat
679 #define wxStrchr strchr
680 #define wxStrcmp strcmp
681 #define wxStrcoll strcoll
682 #define wxStrcpy strcpy
683 #define wxStrcspn strcspn
685 /* wxStricmp and wxStrnicmp are defined below */
686 #define wxStrlen_ strlen /* used in wxStrlen inline function */
687 #define wxStrncat strncat
688 #define wxStrncmp strncmp
689 #define wxStrncpy strncpy
690 #define wxStrpbrk strpbrk
691 #define wxStrrchr strrchr
692 #define wxStrspn strspn
693 #define wxStrstr strstr
694 #define wxStrtod strtod
696 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
698 #define wxStrtol strtol
699 #define wxStrtoul strtoul
700 #define wxStrxfrm strxfrm
702 /* stdio.h functions */
703 #define wxFopen fopen
704 #define wxFreopen freopen
705 #define wxRemove remove
706 #define wxRename rename
708 #define wxPerror perror
709 #define wxTmpnam tmpnam
711 #define wxFgetc fgetc
712 #define wxFgetchar fgetchar
713 #define wxFgets fgets
714 #define wxFputc fputc
715 #define wxFputs fputs
716 #define wxFputchar fputchar
717 #define wxFprintf fprintf
718 #define wxFscanf fscanf
720 #define wxGetchar getchar
722 #define wxPrintf printf
724 #define wxPutchar putchar
726 #define wxScanf scanf
727 #define wxSprintf sprintf
728 #define wxSscanf sscanf
729 #define wxUngetc ungetc
730 #define wxVfprintf vfprintf
731 #define wxVprintf vprintf
732 #define wxVsscanf vsscanf
733 #define wxVsprintf vsprintf
735 /* stdlib.h functions */
739 #define wxGetenv getenv
740 #define wxSystem system
742 /* time.h functions */
743 #define wxAsctime asctime
744 #define wxCtime ctime
745 #define wxStrftime strftime
746 #endif /* Unicode/ASCII */
747 #endif /* TCHAR-aware compilers/the others */
750 various special cases
753 /* define wxStricmp and wxStrnicmp for various compilers */
755 /* note that in Unicode mode we definitely are going to need our own version */
756 #if !defined(wxStricmp) && !wxUSE_UNICODE
757 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
758 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
759 defined(__EMX__) || defined(__DJGPP__)
760 #define wxStricmp stricmp
761 #define wxStrnicmp strnicmp
762 #elif defined(__WXPALMOS__)
763 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
764 * quick hack should do until one can be written.
766 #define wxStricmp StrCaselessCompare
767 #define wxStrnicmp strnicmp
768 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
769 (defined(__MWERKS__) && defined(__INTEL__))
770 #define wxStricmp _stricmp
771 #define wxStrnicmp _strnicmp
772 #elif defined(__UNIX__) || defined(__GNUWIN32__)
773 #define wxStricmp strcasecmp
774 #define wxStrnicmp strncasecmp
775 /* #else -- use wxWidgets implementation */
777 #endif /* !defined(wxStricmp) */
779 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
780 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
781 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
784 #define wxWcslen wcslen
786 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
788 #endif /* wxUSE_WCHAR_T */
791 /* checks whether the passed in pointer is NULL and if the string is empty */
792 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
794 /* safe version of strlen() (returns 0 if passed NULL pointer) */
795 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
799 each of strdup() and wcsdup() may or may not be available but we need both
800 of them anyhow for wx/buffer.h so we define the missing one(s) in
801 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
802 defined -- if this is somehow not the case in some situations, please
803 correct that and not the lines here
806 #define wxStrdup wxStrdupW
808 #define wxStrdup wxStrdupA
812 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
815 /* printf() family saga */
818 For some systems [v]snprintf() exists in the system libraries but not in the
819 headers, so we need to declare it ourselves to be able to use it.
821 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
827 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
828 #endif /* !HAVE_VSNPRINTF_DECL */
830 #if defined(HAVE_SNPRINTF) && !defined(HAVE_SNPRINTF_DECL)
836 int snprintf(char *str
, size_t size
, const char *format
, ...);
837 #endif /* !HAVE_SNPRINTF_DECL */
839 /* Wrapper for vsnprintf if it's 3rd parameter is non-const. Note: the
840 * same isn't done for snprintf below, the builtin wxSnprintf_ is used
841 * instead since it's already a simple wrapper */
842 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
843 inline int wx_fixed_vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
)
845 return vsnprintf(str
, size
, (char*)format
, ap
);
850 First of all, we always want to define safe snprintf() function to be used
851 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
852 which we really need...), otherwise we implement it using our own printf()
855 We define function with a trailing underscore here because the real one is a
856 wrapper around it as explained below
860 #ifdef wxHAVE_MWERKS_UNICODE
861 #define HAVE_WCSRTOMBS 1
862 #define HAVE_VSWPRINTF 1
863 #endif /* Metrowerks with Unicode support */
864 #if defined(__WATCOMC__)
865 #define wxVsnprintf_ _vsnwprintf
866 #define wxSnprintf_ _snwprintf
868 #if defined(HAVE__VSNWPRINTF)
869 #define wxVsnprintf_ _vsnwprintf
870 /* MinGW?MSVCRT has the wrong vswprintf */
871 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
872 #define wxVsnprintf_ vswprintf
875 /* all versions of CodeWarrior supported by wxWidgets apparently have */
876 /* both snprintf() and vsnprintf() */
877 #if defined(HAVE_SNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
878 #ifndef HAVE_BROKEN_SNPRINTF_DECL
879 #define wxSnprintf_ snprintf
882 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
883 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
884 #define wxVsnprintf_ wx_fixed_vsnprintf
886 #define wxVsnprintf_ vsnprintf
890 #endif /* wxVsnprintf_ not defined yet */
893 /* no [v]snprintf(), cook our own */
894 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
895 ...) ATTRIBUTE_PRINTF_3
;
898 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
903 In Unicode mode we need to have all standard functions such as wprintf() and
904 so on but not all systems have them so use our own implementations in this
907 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
908 #define wxNEED_WPRINTF
912 More Unicode complications: although both ANSI C and C++ define a number of
913 wide character functions such as wprintf(), not all environments have them.
914 Worse, those which do have different behaviours: under Windows, %s format
915 specifier changes its meaning in Unicode build and expects a Unicode string
916 while under Unix/POSIX it still means an ASCII string even for wprintf() and
917 %ls has to be used for wide strings.
919 We choose to always emulate Windows behaviour as more useful for us so even
920 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
924 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
926 we need to implement all wide character printf and scanf functions
927 either because we don't have them at all or because they don't have the
931 #include <stdio.h> /* for FILE */
933 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
934 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
935 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
936 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
937 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
938 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
939 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
940 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
941 int wxVprintf( const wxChar
*format
, va_list ap
);
942 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
943 #endif /* wxNEED_PRINTF_CONVERSION */
945 /* these 2 can be simply mapped to the versions with underscore at the end */
946 /* if we don't have to do the conversion */
948 However, if we don't have any vswprintf() at all we don't need to redefine
949 anything as our own wxVsnprintf_() already behaves as needed.
951 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
952 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
953 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
955 #define wxSnprintf wxSnprintf_
956 #define wxVsnprintf wxVsnprintf_
960 various functions which might not be available in libc and for which we
961 provide our own replacements in wxchar.cpp
964 /* ctype.h functions */
966 /* RN: Used only under OSX <= 10.2 currently */
967 #ifdef wxNEED_WX_CTYPE_H
968 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
969 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
970 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
971 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
972 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
973 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
974 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
975 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
976 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
977 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
978 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
979 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
980 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
981 #endif /* wxNEED_WX_CTYPE_H */
983 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
984 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
985 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
987 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
991 a few compilers don't have the (non standard but common) isascii function,
992 define it ourselves for them
995 #if defined(__MWERKS__)
996 #define wxNEED_ISASCII
997 #elif defined(_WIN32_WCE)
998 #if _WIN32_WCE <= 211
999 #define wxNEED_ISASCII
1002 #endif /* isascii */
1004 #ifdef wxNEED_ISASCII
1005 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
1009 #if _WIN32_WCE <= 211
1010 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
1012 #endif /* _WIN32_WCE */
1015 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
1016 initial versions of this header -- now it is too late to remove it so
1017 although we fixed the function/macro name above, still provide the
1018 backwards-compatible synonym.
1020 #define wxIsctrl wxIscntrl
1022 /* string.h functions */
1024 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
1025 #define wxNEED_STRDUP
1026 #elif defined(__WXWINCE__)
1027 #if _WIN32_WCE <= 211
1028 #define wxNEED_STRDUP
1033 #ifdef wxNEED_STRDUP
1034 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
1037 /* RN: Used only under OSX <= 10.2 currently
1038 The __cplusplus ifdefs are messy, but they are required to build
1039 the regex library, since c does not support function overloading
1041 #ifdef wxNEED_WX_STRING_H
1045 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
1046 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
1047 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
1048 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
1049 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
1050 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
1051 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
1052 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
1053 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
1054 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
1055 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
1056 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
1057 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
1062 /* These functions use C++, so we can't c extern them */
1063 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
1064 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1065 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1066 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
1068 /* inlined versions */
1070 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
1071 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
1072 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
1073 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
1074 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
1075 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
1076 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
1077 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
1080 #endif /* wxNEED_WX_STRING_H */
1083 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
1087 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
1091 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
1095 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1099 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1104 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1105 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1109 /* stdio.h functions */
1110 #ifdef wxNEED_WX_STDIO_H
1112 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1113 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1114 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1115 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1117 /* *printf() family is handled separately */
1118 #endif /* wxNEED_WX_STDIO_H */
1121 /* stdlib.h functions */
1123 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1126 #ifdef wxNEED_WX_STDLIB_H
1127 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1128 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1129 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1130 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1134 /* time.h functions */
1135 #ifdef wxNEED_WX_TIME_H
1136 #if defined(__MWERKS__) && defined(macintosh)
1139 /*silent gabby compilers*/
1141 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1142 const wxChar
*fmt
, const struct tm
*tm
);
1143 #endif /* wxNEED_WX_TIME_H */
1147 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1151 /* missing functions in some WinCE versions */
1153 #if (_WIN32_WCE < 300)
1154 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1156 #endif /* _WIN32_WCE */
1158 /* multibyte to wide char conversion functions and macros */
1161 /* multibyte<->widechar conversion */
1162 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1163 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1166 #define wxMB2WX wxMB2WC
1167 #define wxWX2MB wxWC2MB
1168 #define wxWC2WX wxStrncpy
1169 #define wxWX2WC wxStrncpy
1171 #define wxMB2WX wxStrncpy
1172 #define wxWX2MB wxStrncpy
1173 #define wxWC2WX wxWC2MB
1174 #define wxWX2WC wxMB2WC
1176 #else /* !wxUSE_UNICODE */
1177 /* Why is this here?
1179 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1180 #define wxMB2WC wxStrncpy
1181 #define wxWC2MB wxStrncpy
1182 #define wxMB2WX wxStrncpy
1183 #define wxWX2MB wxStrncpy
1184 #define wxWC2WX wxWC2MB
1185 #define wxWX2WC wxMB2WC
1189 RN: The following are not normal versions of memcpy et al., rather
1190 these are either char or widechar versions depending on
1191 if unicode is used or not.
1197 // RN: We could do the usual tricky compiler detection here,
1198 // and use their variant (such as wmemchr, etc.). The problem
1199 // is that these functions are quite rare, even though they are
1200 // part of the current POSIX standard. In addition, most compilers
1201 // (including even MSC) inline them just like we do right in their
1205 #include <string.h> //for mem funcs
1207 //implement our own wmem variants
1208 inline wxChar
* wxTmemchr(const wxChar
* s
, wxChar c
, size_t l
)
1210 for(;l
&& *s
!= c
;--l
, ++s
) {}
1217 inline int wxTmemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1219 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1222 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1227 inline wxChar
* wxTmemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1229 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1232 inline wxChar
* wxTmemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1234 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1237 inline wxChar
* wxTmemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1239 wxChar
* szRet
= szOut
;
1247 #else /* !wxUSE_UNICODE */
1248 # define wxTmemchr memchr
1249 # define wxTmemcmp memcmp
1250 # define wxTmemcpy memcpy
1251 # define wxTmemmove memmove
1252 # define wxTmemset memset
1253 #endif /* wxUSE_UNICODE/!wxUSE_UNICODE */
1255 #endif /*__cplusplus*/
1258 #endif /* _WX_WXCHAR_H_ */