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(__VISUALC__) && __VISUALC__ >= 1400
61 #define wxStrdupA _strdup
62 #elif !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
63 /* use #define, not inline wrapper, as it is tested with #ifndef below */
64 #define wxStrdupA strdup
68 non Unix compilers which do have wchar.h (but not tchar.h which is included
69 below and which includes wchar.h anyhow).
71 Actually MinGW has tchar.h, but it does not include wchar.h
73 #if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__) || defined(__WATCOMC__)
78 #if defined(__MWERKS__) && !defined(__MACH__)
86 /* the current (as of Nov 2002) version of cygwin has a bug in its */
87 /* wchar.h -- there is no extern "C" around the declarations in it and */
88 /* this results in linking errors later; also, at least on some */
89 /* Cygwin versions, wchar.h requires sys/types.h */
91 #include <sys/types.h>
99 #if defined(__CYGWIN__) && defined(__cplusplus)
101 #endif /* Cygwin and C++ */
103 #elif defined(HAVE_WCSTR_H)
104 /* old compilers have relevant declarations here */
106 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
107 /* include stdlib.h for wchar_t */
109 #endif /* HAVE_WCHAR_H */
110 #endif /* wxUSE_WCHAR_T */
112 /* ---------------------------------------------------------------------------- */
113 /* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
114 /* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
115 /* the function mapping _tfoo() -> foo() or wfoo() */
116 /* ---------------------------------------------------------------------------- */
118 /* VC++ and BC++ starting with 5.2 have TCHAR support */
120 #define wxHAVE_TCHAR_SUPPORT
121 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
122 #define wxHAVE_TCHAR_SUPPORT
124 #elif defined(__WATCOMC__)
125 #define wxHAVE_TCHAR_SUPPORT
126 #elif defined(__DMC__)
127 #define wxHAVE_TCHAR_SUPPORT
128 #elif defined(__WXPALMOS__)
130 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 )
131 #define wxHAVE_TCHAR_SUPPORT
135 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
136 /* VZ: the old VisualAge definitions were completely wrong and had no */
137 /* chance at all to work in Unicode build anyhow so let's pretend that */
138 /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
139 /* "0 &&" above) until someone really has time to delve into Unicode */
140 /* issues under OS/2 */
142 /* VisualAge 4.0+ supports TCHAR */
143 #define wxHAVE_TCHAR_SUPPORT
144 #endif /* compilers with (good) TCHAR support */
146 #if defined(__MWERKS__)
147 /* Metrowerks only has wide char support for OS X >= 10.3 */
148 #if !defined(__DARWIN__) || \
149 (MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_3)
150 #define wxHAVE_MWERKS_UNICODE
153 #ifdef wxHAVE_MWERKS_UNICODE
156 #endif /* __MWERKS__ */
158 #ifdef wxHAVE_TCHAR_SUPPORT
159 /* get TCHAR definition if we've got it */
162 /* we surely do have wchar_t if we have TCHAR */
163 #ifndef wxUSE_WCHAR_T
164 #define wxUSE_WCHAR_T 1
165 #endif /* !defined(wxUSE_WCHAR_T) */
167 /* and we also do have wcslen() */
171 #endif /* wxHAVE_TCHAR_SUPPORT */
173 /* ---------------------------------------------------------------------------- */
174 /* define wxChar type */
175 /* ---------------------------------------------------------------------------- */
177 /* TODO: define wxCharInt to be equal to either int or wint_t? */
181 typedef signed char wxSChar
;
182 typedef unsigned char wxUChar
;
184 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
185 /* signed/unsigned version of it which (a) makes sense to me (unlike */
186 /* char wchar_t is always unsigned) and (b) was how the previous */
187 /* definitions worked so keep it like this */
189 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
191 #if !defined(__WCHAR_TYPE__) || \
192 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
194 typedef wchar_t wxChar
;
195 typedef wchar_t wxSChar
;
196 typedef wchar_t wxUChar
;
197 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
198 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
199 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
200 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
201 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
202 /* have to define wxChar conditionally depending on detected */
203 /* compiler & compiler version. */
204 /* with old definition of wxChar. */
205 typedef __WCHAR_TYPE__ wxChar
;
206 typedef __WCHAR_TYPE__ wxSChar
;
207 typedef __WCHAR_TYPE__ wxUChar
;
208 #endif /* __WCHAR_TYPE__ */
209 #endif /* ASCII/Unicode */
211 /* ---------------------------------------------------------------------------- */
212 /* define _T() and related macros */
213 /* ---------------------------------------------------------------------------- */
215 /* BSD systems define _T() to be something different in ctype.h, override it */
216 #if defined(__FreeBSD__) || defined(__DARWIN__)
221 /* could already be defined by tchar.h (it's quasi standard) */
227 #endif /* ASCII/Unicode */
228 #endif /* !defined(_T) */
230 /* although global macros with such names are normally bad, we want to have */
231 /* another name for _T() which should be used to avoid confusion between _T() */
232 /* and _() in wxWidgets sources */
235 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
237 #define __XFILE__(x) wxT(x)
238 #define __TFILE__ __XFILE__(__FILE__)
242 #define __XDATE__(x) wxT(x)
243 #define __TDATE__ __XDATE__(__DATE__)
247 #define __XTIME__(x) wxT(x)
248 #define __TTIME__ __XTIME__(__TIME__)
252 define wxFoo() function for each standard foo() function whose signature
253 (exceptionally including the return type) includes any mention of char:
254 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
255 the same signature but with char replaced by wxChar which allows us to use
256 it in Unicode build as well
259 #ifdef wxHAVE_TCHAR_SUPPORT
262 #if defined(__WATCOMC__) && defined(UNICODE)
263 #define WXWCHAR_T_CAST(c) (wint_t)(c)
265 #define WXWCHAR_T_CAST(c) c
268 /* ctype.h functions */
269 #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
270 #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
271 #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
272 #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
273 #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
274 #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
275 #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
276 #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
277 #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
278 #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
279 #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
282 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
283 signed chars < 0, so "fix" it here.
285 #define wxTolower(c) _totlower((wxUChar)(c))
286 #define wxToupper(c) _totupper((wxUChar)(c))
288 /* locale.h functons */
289 #define wxSetlocale _tsetlocale
291 /* string.h functions */
292 #define wxStrcat _tcscat
293 #define wxStrchr _tcschr
294 #define wxStrcmp _tcscmp
295 #define wxStrcoll _tcscoll
296 #define wxStrcpy _tcscpy
297 #define wxStrcspn _tcscspn
298 #define wxStrdupW _wcsdup /* notice the 'W'! */
299 #define wxStrftime _tcsftime
300 #define wxStricmp _tcsicmp
301 #define wxStrnicmp _tcsnicmp
302 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
303 #define wxStrncat _tcsncat
304 #define wxStrncmp _tcsncmp
305 #define wxStrncpy _tcsncpy
306 #define wxStrpbrk _tcspbrk
307 #define wxStrrchr _tcsrchr
308 #define wxStrspn _tcsspn
309 #define wxStrstr _tcsstr
310 #define wxStrtod _tcstod
311 #define wxStrtol _tcstol
312 #define wxStrtoul _tcstoul
313 #define wxStrxfrm _tcsxfrm
315 /* stdio.h functions */
316 #define wxFgetc _fgettc
317 #define wxFgetchar _fgettchar
318 #define wxFgets _fgetts
319 #if wxUSE_UNICODE_MSLU
320 #define wxFopen wxMSLU__tfopen
322 #define wxFopen _tfopen
324 #define wxFputc _fputtc
325 #define wxFputchar _fputtchar
326 #define wxFprintf _ftprintf
327 #define wxFputs _fputts
328 #define wxFreopen _tfreopen
329 #define wxFscanf _ftscanf
330 #define wxGetc _gettc
331 #define wxGetchar _gettchar
332 #define wxGets _getts
333 #define wxPerror _tperror
334 #define wxPrintf _tprintf
335 #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
336 #define wxPutchar _puttchar
337 #define wxPuts _putts
338 #define wxScanf _tscanf
341 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
342 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
344 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
345 #define wxSprintf sprintf
348 #define wxSprintf _stprintf
351 #define wxSscanf _stscanf
352 #define wxTmpnam _ttmpnam
353 #define wxUngetc _tungetc
354 #define wxVfprintf _vftprintf
355 #define wxVprintf _vtprintf
356 #define wxVsscanf _vstscanf
357 #define wxVsprintf _vstprintf
359 /* special case: not all TCHAR-aware compilers have those */
360 #if defined(__VISUALC__) || \
361 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
362 #define wxVsnprintf_ _vsntprintf
363 #define wxSnprintf_ _sntprintf
366 /* special case: these functions are missing under Win9x with Unicows so we */
367 /* have to implement them ourselves */
368 #if wxUSE_UNICODE_MSLU
369 #define wxRemove wxMSLU__tremove
370 #define wxRename wxMSLU__trename
373 /* carefully: wxRemove() must return 0 on success while DeleteFile()
374 returns 0 on error, so don't just define one as the other */
375 int wxRemove(const wxChar
*path
);
377 #define wxRemove _tremove
378 #define wxRename _trename
382 /* stdlib.h functions */
385 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
386 /* there are no env vars at all under CE, so no _tgetenv neither */
388 /* can't define as inline function as this is a C file... */
389 #define wxGetenv(name) ((wxChar *)NULL)
391 #define wxGetenv _tgetenv
393 #define wxSystem _tsystem
395 /* time.h functions */
396 #define wxAsctime _tasctime
397 #define wxCtime _tctime
399 #define wxMbstowcs mbstowcs
400 #define wxWcstombs wcstombs
401 #else /* !TCHAR-aware compilers */
403 There are 2 unrelated problems with these functions under Mac:
404 a) Metrowerks MSL CRT implements them strictly in C99 sense and
405 doesn't support (very common) extension of allowing to call
406 mbstowcs(NULL, ...) which makes it pretty useless as you can't
407 know the size of the needed buffer
408 b) OS X <= 10.2 declares and even defined these functions but
409 doesn't really implement them -- they always return an error
411 So use our own replacements in both cases.
413 #if defined(__MWERKS__) && defined(__MSL__)
414 #define wxNEED_WX_MBSTOWCS
418 #if MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2
419 #define wxNEED_WX_MBSTOWCS
423 #ifdef wxNEED_WX_MBSTOWCS
424 /* even though they are defined and "implemented", they are bad and just
425 stubs so we need our own - we need these even in ANSI builds!! */
426 WXDLLIMPEXP_BASE
size_t wxMbstowcs (wchar_t *, const char *, size_t);
427 WXDLLIMPEXP_BASE
size_t wxWcstombs (char *, const wchar_t *, size_t);
429 #define wxMbstowcs mbstowcs
430 #define wxWcstombs wcstombs
434 The system C library on Mac OS X 10.2 and below does not support
435 unicode: in other words all wide-character functions such as towupper et
436 al. do simply not exist so we need to provide our own in that context,
437 except for the wchar_t definition/typedef itself.
439 We need to do this for both project builder and CodeWarrior as
440 the latter uses the system C library in Mach builds for wide character
441 support, which as mentioned does not exist on 10.2 and below.
443 #if wxUSE_UNICODE && \
444 defined(__DARWIN__) && \
445 ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
446 /* we need everything! */
447 #define wxNEED_WX_STRING_H
448 #define wxNEED_WX_CTYPE_H
450 #define wxFgetchar(c) wxFgetc(c, stdin)
451 #define wxFputc wxPutc
452 #define wxFputchar(c) wxPutc(c, stdout)
453 #define wxGetc wxFgetc
454 #define wxGetchar(c) wxFgetc(c, stdin)
461 #define wxNEED_UNGETC
467 int wxFputs(const wxChar
*ch
, FILE *stream
);
468 int wxPuts(const wxChar
*ws
);
469 int wxPutc(wxChar ch
, FILE *stream
);
474 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
479 #define wxPutchar(wch) wxPutc(wch, stdout)
481 #define wxNEED_PRINTF_CONVERSION
482 #define wxNEED_WX_STDIO_H
483 #define wxNEED_WX_STDLIB_H
484 #define wxNEED_WX_TIME_H
489 /* this is probably glibc-specific */
490 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
491 /* ctype.h functions (wctype.h) */
492 #define wxIsalnum iswalnum
493 #define wxIsalpha iswalpha
494 #define wxIscntrl iswcntrl
495 #define wxIsdigit iswdigit
496 #define wxIsgraph iswgraph
497 #define wxIslower iswlower
498 #define wxIsprint iswprint
499 #define wxIspunct iswpunct
500 #define wxIsspace iswspace
501 #define wxIsupper iswupper
502 #define wxIsxdigit iswxdigit
504 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
505 /* /usr/include/wctype.h incorrectly declares translations */
506 /* tables which provokes tons of compile-time warnings -- try */
507 /* to correct this */
508 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
509 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
510 #else /* !glibc 2.0 */
511 #define wxTolower towlower
512 #define wxToupper towupper
513 #endif /* gcc/!gcc */
515 /* string.h functions (wchar.h) */
516 #define wxStrcat wcscat
517 #define wxStrchr wcschr
518 #define wxStrcmp wcscmp
519 #define wxStrcoll wcscoll
520 #define wxStrcpy wcscpy
521 #define wxStrcspn wcscspn
522 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
523 #define wxStrncat wcsncat
524 #define wxStrncmp wcsncmp
525 #define wxStrncpy wcsncpy
526 #define wxStrpbrk wcspbrk
527 #define wxStrrchr wcsrchr
528 #define wxStrspn wcsspn
529 #define wxStrstr wcsstr
530 #define wxStrtod wcstod
531 #define wxStrtol wcstol
532 #define wxStrtoul wcstoul
533 #define wxStrxfrm wcsxfrm
535 #define wxFgetc fgetwc
536 #define wxFgetchar fgetwchar
537 #define wxFgets fgetws
538 #define wxFputc fputwc
539 #define wxFputchar fputwchar
541 #define wxGetchar getwchar
543 #define wxUngetc ungetwc
546 #define wxFputs fputws
550 int wxFputs(const wxChar
*ch
, FILE *stream
);
558 int wxPutc(wxChar ch
, FILE *stream
);
562 #define wxPutchar wputchar
564 #define wxPutchar(wch) wxPutc(wch, stdout)
571 int wxPuts(const wxChar
*ws
);
574 /* we need %s to %ls conversion for printf and scanf etc */
575 #define wxNEED_PRINTF_CONVERSION
577 /* glibc doesn't have wide char equivalents of the other stuff so */
578 /* use our own versions */
579 #define wxNEED_WX_STDIO_H
580 #define wxNEED_WX_STDLIB_H
581 #define wxNEED_WX_TIME_H
582 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
583 /* ctype.h functions (wctype.h) */
584 #define wxIsalnum iswalnum
585 #define wxIsalpha iswalpha
586 #define wxIscntrl iswcntrl
587 #define wxIsdigit iswdigit
588 #define wxIsgraph iswgraph
589 #define wxIslower iswlower
590 #define wxIsprint iswprint
591 #define wxIspunct iswpunct
592 #define wxIsspace iswspace
593 #define wxIsupper iswupper
594 #define wxIsxdigit iswxdigit
595 #define wxTolower towlower
596 #define wxToupper towupper
598 /* string.h functions (wchar.h) */
599 #define wxStrcat wcscat
600 #define wxStrchr wcschr
601 #define wxStrcmp wcscmp
602 #define wxStrcoll wcscoll
603 #define wxStrcpy wcscpy
604 #define wxStrcspn wcscspn
605 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
606 #define wxStrncat wcsncat
607 #define wxStrncmp wcsncmp
608 #define wxStrncpy wcsncpy
609 #define wxStrpbrk wcspbrk
610 #define wxStrrchr wcsrchr
611 #define wxStrspn wcsspn
612 #define wxStrstr wcsstr
613 #define wxStrtod wcstod
614 #define wxStrtol wcstol
615 #define wxStrtoul wcstoul
616 #define wxStrxfrm wcsxfrm
618 #define wxFgetc fgetwc
619 #define wxFgetchar fgetwchar
620 #define wxFgets fgetws
621 #define wxFputc fputwc
622 #define wxFputchar fputwchar
624 #define wxGetchar getwchar
626 #define wxUngetc ungetwc
628 #define wxNEED_PRINTF_CONVERSION
631 #define wxPutchar putwchar
632 #define wxFputs fputws
634 /* stdio.h functions */
636 #define wxNEED_WX_STDIO_H
638 /* stdlib.h functions */
640 #define wxNEED_WX_STDLIB_H
645 #define wxGetenv(a) ((wxChar*)NULL)
646 #define wxSystem(a) ((int)NULL)
648 /* time.h functions */
649 #define wxAsctime wasciitime
650 #define wxCtime wctime
651 /* #define wxStrftime wcsftime */
653 #define wxNEED_WX_TIME_H
654 #else /* !metrowerks for apple */
655 #error "Please define wide character functions for your environment"
661 /* ctype.h functions */
662 #define wxIsalnum isalnum
663 #define wxIsalpha isalpha
664 #define wxIscntrl iscntrl
665 #define wxIsdigit isdigit
666 #define wxIsgraph isgraph
667 #define wxIslower islower
668 #define wxIsprint isprint
669 #define wxIspunct ispunct
670 #define wxIsspace isspace
671 #define wxIsupper isupper
672 #define wxIsxdigit isxdigit
673 #define wxTolower tolower
674 #define wxToupper toupper
676 /* locale.h functons */
677 #define wxSetlocale setlocale
679 /* string.h functions */
680 #define wxStrcat strcat
681 #define wxStrchr strchr
682 #define wxStrcmp strcmp
683 #define wxStrcoll strcoll
684 #define wxStrcpy strcpy
685 #define wxStrcspn strcspn
687 /* wxStricmp and wxStrnicmp are defined below */
688 #define wxStrlen_ strlen /* used in wxStrlen inline function */
689 #define wxStrncat strncat
690 #define wxStrncmp strncmp
691 #define wxStrncpy strncpy
692 #define wxStrpbrk strpbrk
693 #define wxStrrchr strrchr
694 #define wxStrspn strspn
695 #define wxStrstr strstr
696 #define wxStrtod strtod
698 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
700 #define wxStrtol strtol
701 #define wxStrtoul strtoul
702 #define wxStrxfrm strxfrm
704 /* stdio.h functions */
705 #define wxFopen fopen
706 #define wxFreopen freopen
707 #define wxRemove remove
708 #define wxRename rename
710 #define wxPerror perror
711 #define wxTmpnam tmpnam
713 #define wxFgetc fgetc
714 #define wxFgetchar fgetchar
715 #define wxFgets fgets
716 #define wxFputc fputc
717 #define wxFputs fputs
718 #define wxFputchar fputchar
719 #define wxFprintf fprintf
720 #define wxFscanf fscanf
722 #define wxGetchar getchar
724 #define wxPrintf printf
726 #define wxPutchar putchar
728 #define wxScanf scanf
729 #define wxSprintf sprintf
730 #define wxSscanf sscanf
731 #define wxUngetc ungetc
732 #define wxVfprintf vfprintf
733 #define wxVprintf vprintf
734 #define wxVsscanf vsscanf
735 #define wxVsprintf vsprintf
737 /* stdlib.h functions */
741 #define wxGetenv getenv
742 #define wxSystem system
744 /* time.h functions */
745 #define wxAsctime asctime
746 #define wxCtime ctime
747 #define wxStrftime strftime
748 #endif /* Unicode/ASCII */
749 #endif /* TCHAR-aware compilers/the others */
752 various special cases
755 /* define wxStricmp and wxStrnicmp for various compilers */
757 /* note that in Unicode mode we definitely are going to need our own version */
758 #if !defined(wxStricmp) && !wxUSE_UNICODE
759 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
760 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
761 defined(__EMX__) || defined(__DJGPP__)
762 #define wxStricmp stricmp
763 #define wxStrnicmp strnicmp
764 #elif defined(__WXPALMOS__)
765 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
766 * quick hack should do until one can be written.
768 #define wxStricmp StrCaselessCompare
769 #define wxStrnicmp strnicmp
770 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
771 (defined(__MWERKS__) && defined(__INTEL__))
772 #define wxStricmp _stricmp
773 #define wxStrnicmp _strnicmp
774 #elif defined(__UNIX__) || defined(__GNUWIN32__)
775 #define wxStricmp strcasecmp
776 #define wxStrnicmp strncasecmp
777 /* #else -- use wxWidgets implementation */
779 #endif /* !defined(wxStricmp) */
781 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
782 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
783 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
786 #define wxWcslen wcslen
788 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
790 #endif /* wxUSE_WCHAR_T */
793 /* checks whether the passed in pointer is NULL and if the string is empty */
794 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
796 /* safe version of strlen() (returns 0 if passed NULL pointer) */
797 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
801 each of strdup() and wcsdup() may or may not be available but we need both
802 of them anyhow for wx/buffer.h so we define the missing one(s) in
803 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
804 defined -- if this is somehow not the case in some situations, please
805 correct that and not the lines here
808 #define wxStrdup wxStrdupW
810 #define wxStrdup wxStrdupA
814 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
817 /* printf() family saga */
820 For some systems [v]snprintf() exists in the system libraries but not in the
821 headers, so we need to declare it ourselves to be able to use it.
823 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
829 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
830 #endif /* !HAVE_VSNPRINTF_DECL */
832 #if defined(HAVE_SNPRINTF) && !defined(HAVE_SNPRINTF_DECL)
838 int snprintf(char *str
, size_t size
, const char *format
, ...);
839 #endif /* !HAVE_SNPRINTF_DECL */
841 /* Wrapper for vsnprintf if it's 3rd parameter is non-const. Note: the
842 * same isn't done for snprintf below, the builtin wxSnprintf_ is used
843 * instead since it's already a simple wrapper */
844 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
845 inline int wx_fixed_vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
)
847 return vsnprintf(str
, size
, (char*)format
, ap
);
852 First of all, we always want to define safe snprintf() function to be used
853 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
854 which we really need...), otherwise we implement it using our own printf()
857 We define function with a trailing underscore here because the real one is a
858 wrapper around it as explained below
862 #ifdef wxHAVE_MWERKS_UNICODE
863 #define HAVE_WCSRTOMBS 1
864 #define HAVE_VSWPRINTF 1
865 #endif /* Metrowerks with Unicode support */
866 #if defined(__WATCOMC__)
867 #define wxVsnprintf_ _vsnwprintf
868 #define wxSnprintf_ _snwprintf
870 #if defined(HAVE__VSNWPRINTF)
871 #define wxVsnprintf_ _vsnwprintf
872 /* MinGW?MSVCRT has the wrong vswprintf */
873 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
874 #define wxVsnprintf_ vswprintf
877 /* all versions of CodeWarrior supported by wxWidgets apparently have */
878 /* both snprintf() and vsnprintf() */
879 #if defined(HAVE_SNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
880 #ifndef HAVE_BROKEN_SNPRINTF_DECL
881 #define wxSnprintf_ snprintf
884 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
885 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
886 #define wxVsnprintf_ wx_fixed_vsnprintf
888 #define wxVsnprintf_ vsnprintf
892 #endif /* wxVsnprintf_ not defined yet */
895 /* no [v]snprintf(), cook our own */
896 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
897 ...) ATTRIBUTE_PRINTF_3
;
900 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
905 In Unicode mode we need to have all standard functions such as wprintf() and
906 so on but not all systems have them so use our own implementations in this
909 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
910 #define wxNEED_WPRINTF
914 More Unicode complications: although both ANSI C and C++ define a number of
915 wide character functions such as wprintf(), not all environments have them.
916 Worse, those which do have different behaviours: under Windows, %s format
917 specifier changes its meaning in Unicode build and expects a Unicode string
918 while under Unix/POSIX it still means an ASCII string even for wprintf() and
919 %ls has to be used for wide strings.
921 We choose to always emulate Windows behaviour as more useful for us so even
922 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
926 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
928 we need to implement all wide character printf and scanf functions
929 either because we don't have them at all or because they don't have the
933 #include <stdio.h> /* for FILE */
935 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
936 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
937 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
938 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
939 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
940 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
941 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
942 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
943 int wxVprintf( const wxChar
*format
, va_list ap
);
944 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
945 #endif /* wxNEED_PRINTF_CONVERSION */
947 /* these 2 can be simply mapped to the versions with underscore at the end */
948 /* if we don't have to do the conversion */
950 However, if we don't have any vswprintf() at all we don't need to redefine
951 anything as our own wxVsnprintf_() already behaves as needed.
953 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
954 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
955 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
957 #define wxSnprintf wxSnprintf_
958 #define wxVsnprintf wxVsnprintf_
962 various functions which might not be available in libc and for which we
963 provide our own replacements in wxchar.cpp
966 /* ctype.h functions */
968 /* RN: Used only under OSX <= 10.2 currently */
969 #ifdef wxNEED_WX_CTYPE_H
970 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
971 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
972 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
973 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
974 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
975 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
976 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
977 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
978 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
979 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
980 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
981 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
982 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
983 #endif /* wxNEED_WX_CTYPE_H */
985 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
986 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
987 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
989 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
993 a few compilers don't have the (non standard but common) isascii function,
994 define it ourselves for them
997 #if defined(__MWERKS__)
998 #define wxNEED_ISASCII
999 #elif defined(_WIN32_WCE)
1000 #if _WIN32_WCE <= 211
1001 #define wxNEED_ISASCII
1004 #endif /* isascii */
1006 #ifdef wxNEED_ISASCII
1007 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
1011 #if _WIN32_WCE <= 211
1012 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
1014 #endif /* _WIN32_WCE */
1017 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
1018 initial versions of this header -- now it is too late to remove it so
1019 although we fixed the function/macro name above, still provide the
1020 backwards-compatible synonym.
1022 #define wxIsctrl wxIscntrl
1024 /* string.h functions */
1026 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
1027 #define wxNEED_STRDUP
1028 #elif defined(__WXWINCE__)
1029 #if _WIN32_WCE <= 211
1030 #define wxNEED_STRDUP
1035 #ifdef wxNEED_STRDUP
1036 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
1039 /* RN: Used only under OSX <= 10.2 currently
1040 The __cplusplus ifdefs are messy, but they are required to build
1041 the regex library, since c does not support function overloading
1043 #ifdef wxNEED_WX_STRING_H
1047 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
1048 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
1049 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
1050 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
1051 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
1052 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
1053 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
1054 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
1055 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
1056 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
1057 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
1058 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
1059 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
1064 /* These functions use C++, so we can't c extern them */
1065 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
1066 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1067 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1068 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
1070 /* inlined versions */
1072 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
1073 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
1074 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
1075 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
1076 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
1077 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
1078 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
1079 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
1082 #endif /* wxNEED_WX_STRING_H */
1085 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
1089 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
1093 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
1097 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1101 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1106 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1107 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1111 /* stdio.h functions */
1112 #ifdef wxNEED_WX_STDIO_H
1114 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1115 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1116 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1117 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1119 /* *printf() family is handled separately */
1120 #endif /* wxNEED_WX_STDIO_H */
1123 /* stdlib.h functions */
1125 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1128 #ifdef wxNEED_WX_STDLIB_H
1129 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1130 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1131 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1132 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1136 /* time.h functions */
1137 #ifdef wxNEED_WX_TIME_H
1138 #if defined(__MWERKS__) && defined(macintosh)
1141 /*silent gabby compilers*/
1143 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1144 const wxChar
*fmt
, const struct tm
*tm
);
1145 #endif /* wxNEED_WX_TIME_H */
1149 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1153 /* missing functions in some WinCE versions */
1155 #if (_WIN32_WCE < 300)
1156 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1158 #endif /* _WIN32_WCE */
1160 /* multibyte to wide char conversion functions and macros */
1163 /* multibyte<->widechar conversion */
1164 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1165 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1168 #define wxMB2WX wxMB2WC
1169 #define wxWX2MB wxWC2MB
1170 #define wxWC2WX wxStrncpy
1171 #define wxWX2WC wxStrncpy
1173 #define wxMB2WX wxStrncpy
1174 #define wxWX2MB wxStrncpy
1175 #define wxWC2WX wxWC2MB
1176 #define wxWX2WC wxMB2WC
1178 #else /* !wxUSE_UNICODE */
1179 /* Why is this here?
1181 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1182 #define wxMB2WC wxStrncpy
1183 #define wxWC2MB wxStrncpy
1184 #define wxMB2WX wxStrncpy
1185 #define wxWX2MB wxStrncpy
1186 #define wxWC2WX wxWC2MB
1187 #define wxWX2WC wxMB2WC
1191 RN: The following are not normal versions of memcpy et al., rather
1192 these are either char or widechar versions depending on
1193 if unicode is used or not.
1199 // RN: We could do the usual tricky compiler detection here,
1200 // and use their variant (such as wmemchr, etc.). The problem
1201 // is that these functions are quite rare, even though they are
1202 // part of the current POSIX standard. In addition, most compilers
1203 // (including even MSC) inline them just like we do right in their
1207 #include <string.h> //for mem funcs
1209 //implement our own wmem variants
1210 inline wxChar
* wxTmemchr(const wxChar
* s
, wxChar c
, size_t l
)
1212 for(;l
&& *s
!= c
;--l
, ++s
) {}
1219 inline int wxTmemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1221 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1224 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1229 inline wxChar
* wxTmemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1231 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1234 inline wxChar
* wxTmemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1236 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1239 inline wxChar
* wxTmemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1241 wxChar
* szRet
= szOut
;
1249 #else /* !wxUSE_UNICODE */
1250 # define wxTmemchr memchr
1251 # define wxTmemcmp memcmp
1252 # define wxTmemcpy memcpy
1253 # define wxTmemmove memmove
1254 # define wxTmemset memset
1255 #endif /* wxUSE_UNICODE/!wxUSE_UNICODE */
1257 #endif /*__cplusplus*/
1260 #endif /* _WX_WXCHAR_H_ */