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 */
148 #ifdef wxHAVE_TCHAR_SUPPORT
149 /* get TCHAR definition if we've got it */
152 /* we surely do have wchar_t if we have TCHAR */
153 #ifndef wxUSE_WCHAR_T
154 #define wxUSE_WCHAR_T 1
155 #endif /* !defined(wxUSE_WCHAR_T) */
157 /* and we also do have wcslen() */
161 #endif /* wxHAVE_TCHAR_SUPPORT */
163 /* ---------------------------------------------------------------------------- */
164 /* define wxChar type */
165 /* ---------------------------------------------------------------------------- */
167 /* TODO: define wxCharInt to be equal to either int or wint_t? */
171 typedef signed char wxSChar
;
172 typedef unsigned char wxUChar
;
174 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
175 /* signed/unsigned version of it which (a) makes sense to me (unlike */
176 /* char wchar_t is always unsigned) and (b) was how the previous */
177 /* definitions worked so keep it like this */
179 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
181 #if !defined(__WCHAR_TYPE__) || \
182 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
184 typedef wchar_t wxChar
;
185 typedef wchar_t wxSChar
;
186 typedef wchar_t wxUChar
;
187 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
188 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
189 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
190 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
191 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
192 /* have to define wxChar conditionally depending on detected */
193 /* compiler & compiler version. */
194 /* with old definition of wxChar. */
195 typedef __WCHAR_TYPE__ wxChar
;
196 typedef __WCHAR_TYPE__ wxSChar
;
197 typedef __WCHAR_TYPE__ wxUChar
;
198 #endif /* __WCHAR_TYPE__ */
199 #endif /* ASCII/Unicode */
201 /* ---------------------------------------------------------------------------- */
202 /* define _T() and related macros */
203 /* ---------------------------------------------------------------------------- */
205 /* BSD systems define _T() to be something different in ctype.h, override it */
206 #if defined(__FreeBSD__) || defined(__DARWIN__)
211 /* could already be defined by tchar.h (it's quasi standard) */
217 #endif /* ASCII/Unicode */
218 #endif /* !defined(_T) */
220 /* although global macros with such names are normally bad, we want to have */
221 /* another name for _T() which should be used to avoid confusion between _T() */
222 /* and _() in wxWidgets sources */
225 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
227 #define __XFILE__(x) wxT(x)
228 #define __TFILE__ __XFILE__(__FILE__)
232 #define __XDATE__(x) wxT(x)
233 #define __TDATE__ __XDATE__(__DATE__)
237 #define __XTIME__(x) wxT(x)
238 #define __TTIME__ __XTIME__(__TIME__)
242 define wxFoo() function for each standard foo() function whose signature
243 (exceptionally including the return type) includes any mention of char:
244 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
245 the same signature but with char replaced by wxChar which allows us to use
246 it in Unicode build as well
249 #ifdef wxHAVE_TCHAR_SUPPORT
252 #if defined(__WATCOMC__) && defined(UNICODE)
253 #define WXWCHAR_T_CAST(c) (wint_t)(c)
255 #define WXWCHAR_T_CAST(c) c
258 /* ctype.h functions */
259 #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
260 #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
261 #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
262 #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
263 #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
264 #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
265 #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
266 #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
267 #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
268 #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
269 #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
272 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
273 signed chars < 0, so "fix" it here.
275 #define wxTolower(c) _totlower((wxUChar)(c))
276 #define wxToupper(c) _totupper((wxUChar)(c))
278 /* locale.h functons */
279 #define wxSetlocale _tsetlocale
281 /* string.h functions */
282 #define wxStrcat _tcscat
283 #define wxStrchr _tcschr
284 #define wxStrcmp _tcscmp
285 #define wxStrcoll _tcscoll
286 #define wxStrcpy _tcscpy
287 #define wxStrcspn _tcscspn
288 #define wxStrdupW _wcsdup /* notice the 'W'! */
289 #define wxStrftime _tcsftime
290 #define wxStricmp _tcsicmp
291 #define wxStrnicmp _tcsnicmp
292 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
293 #define wxStrncat _tcsncat
294 #define wxStrncmp _tcsncmp
295 #define wxStrncpy _tcsncpy
296 #define wxStrpbrk _tcspbrk
297 #define wxStrrchr _tcsrchr
298 #define wxStrspn _tcsspn
299 #define wxStrstr _tcsstr
300 #define wxStrtod _tcstod
301 #define wxStrtol _tcstol
302 #define wxStrtoul _tcstoul
303 #define wxStrxfrm _tcsxfrm
305 /* stdio.h functions */
306 #define wxFgetc _fgettc
307 #define wxFgetchar _fgettchar
308 #define wxFgets _fgetts
309 #if wxUSE_UNICODE_MSLU
310 #define wxFopen wxMSLU__tfopen
312 #define wxFopen _tfopen
314 #define wxFputc _fputtc
315 #define wxFputchar _fputtchar
316 #define wxFprintf _ftprintf
317 #define wxFputs _fputts
318 #define wxFreopen _tfreopen
319 #define wxFscanf _ftscanf
320 #define wxGetc _gettc
321 #define wxGetchar _gettchar
322 #define wxGets _getts
323 #define wxPerror _tperror
324 #define wxPrintf _tprintf
325 #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
326 #define wxPutchar _puttchar
327 #define wxPuts _putts
328 #define wxScanf _tscanf
331 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
332 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
334 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
335 #define wxSprintf sprintf
338 #define wxSprintf _stprintf
341 #define wxSscanf _stscanf
342 #define wxTmpnam _ttmpnam
343 #define wxUngetc _tungetc
344 #define wxVfprintf _vftprintf
345 #define wxVprintf _vtprintf
346 #define wxVsscanf _vstscanf
347 #define wxVsprintf _vstprintf
349 /* special case: not all TCHAR-aware compilers have those */
350 #if defined(__VISUALC__) || \
351 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
352 #define wxVsnprintf_ _vsntprintf
353 #define wxSnprintf_ _sntprintf
356 /* special case: these functions are missing under Win9x with Unicows so we */
357 /* have to implement them ourselves */
358 #if wxUSE_UNICODE_MSLU
359 #define wxRemove wxMSLU__tremove
360 #define wxRename wxMSLU__trename
363 /* carefully: wxRemove() must return 0 on success while DeleteFile()
364 returns 0 on error, so don't just define one as the other */
365 int wxRemove(const wxChar
*path
);
367 #define wxRemove _tremove
368 #define wxRename _trename
372 /* stdlib.h functions */
375 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
376 /* there are no env vars at all under CE, so no _tgetenv neither */
378 /* can't define as inline function as this is a C file... */
379 #define wxGetenv(name) ((wxChar *)NULL)
381 #define wxGetenv _tgetenv
383 #define wxSystem _tsystem
385 /* time.h functions */
386 #define wxAsctime _tasctime
387 #define wxCtime _tctime
389 #define wxMbstowcs mbstowcs
390 #define wxWcstombs wcstombs
391 #else /* !TCHAR-aware compilers */
393 #if !defined(__MWERKS__) && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
394 /* even though they are defined and "implemented", they are bad and just
395 stubs so we need our own - we need these even in ANSI builds!! */
396 WXDLLIMPEXP_BASE
size_t wxMbstowcs (wchar_t *, const char *, size_t);
397 WXDLLIMPEXP_BASE
size_t wxWcstombs (char *, const wchar_t *, size_t);
399 #define wxMbstowcs mbstowcs
400 #define wxWcstombs wcstombs
403 /* No UNICODE in the c library except wchar_t typedef on mac OSX 10.2 and less - roll our own */
404 #if !defined(__MWERKS__) && wxUSE_UNICODE && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
406 /* we need everything! */
407 #define wxNEED_WX_STRING_H
408 #define wxNEED_WX_CTYPE_H
410 #define wxFgetchar(c) wxFgetc(c, stdin)
411 #define wxFputc wxPutc
412 #define wxFputchar(c) wxPutc(c, stdout)
413 #define wxGetc wxFgetc
414 #define wxGetchar(c) wxFgetc(c, stdin)
421 #define wxNEED_UNGETC
427 int wxFputs(const wxChar
*ch
, FILE *stream
);
428 int wxPuts(const wxChar
*ws
);
429 int wxPutc(wxChar ch
, FILE *stream
);
434 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
439 #define wxPutchar(wch) wxPutc(wch, stdout)
441 #define wxNEED_PRINTF_CONVERSION
442 #define wxNEED_WX_STDIO_H
443 #define wxNEED_WX_STDLIB_H
444 #define wxNEED_WX_TIME_H
449 /* this is probably glibc-specific */
450 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
451 /* ctype.h functions (wctype.h) */
452 #define wxIsalnum iswalnum
453 #define wxIsalpha iswalpha
454 #define wxIscntrl iswcntrl
455 #define wxIsdigit iswdigit
456 #define wxIsgraph iswgraph
457 #define wxIslower iswlower
458 #define wxIsprint iswprint
459 #define wxIspunct iswpunct
460 #define wxIsspace iswspace
461 #define wxIsupper iswupper
462 #define wxIsxdigit iswxdigit
464 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
465 /* /usr/include/wctype.h incorrectly declares translations */
466 /* tables which provokes tons of compile-time warnings -- try */
467 /* to correct this */
468 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
469 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
470 #else /* !glibc 2.0 */
471 #define wxTolower towlower
472 #define wxToupper towupper
473 #endif /* gcc/!gcc */
475 /* string.h functions (wchar.h) */
476 #define wxStrcat wcscat
477 #define wxStrchr wcschr
478 #define wxStrcmp wcscmp
479 #define wxStrcoll wcscoll
480 #define wxStrcpy wcscpy
481 #define wxStrcspn wcscspn
482 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
483 #define wxStrncat wcsncat
484 #define wxStrncmp wcsncmp
485 #define wxStrncpy wcsncpy
486 #define wxStrpbrk wcspbrk
487 #define wxStrrchr wcsrchr
488 #define wxStrspn wcsspn
489 #define wxStrstr wcsstr
490 #define wxStrtod wcstod
491 #define wxStrtol wcstol
492 #define wxStrtoul wcstoul
493 #define wxStrxfrm wcsxfrm
495 #define wxFgetc fgetwc
496 #define wxFgetchar fgetwchar
497 #define wxFgets fgetws
498 #define wxFputc fputwc
499 #define wxFputchar fputwchar
501 #define wxGetchar getwchar
503 #define wxUngetc ungetwc
506 #define wxFputs fputws
510 int wxFputs(const wxChar
*ch
, FILE *stream
);
518 int wxPutc(wxChar ch
, FILE *stream
);
522 #define wxPutchar wputchar
524 #define wxPutchar(wch) wxPutc(wch, stdout)
531 int wxPuts(const wxChar
*ws
);
534 /* we need %s to %ls conversion for printf and scanf etc */
535 #define wxNEED_PRINTF_CONVERSION
537 /* glibc doesn't have wide char equivalents of the other stuff so */
538 /* use our own versions */
539 #define wxNEED_WX_STDIO_H
540 #define wxNEED_WX_STDLIB_H
541 #define wxNEED_WX_TIME_H
542 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
543 /* ctype.h functions (wctype.h) */
544 #define wxIsalnum iswalnum
545 #define wxIsalpha iswalpha
546 #define wxIscntrl iswcntrl
547 #define wxIsdigit iswdigit
548 #define wxIsgraph iswgraph
549 #define wxIslower iswlower
550 #define wxIsprint iswprint
551 #define wxIspunct iswpunct
552 #define wxIsspace iswspace
553 #define wxIsupper iswupper
554 #define wxIsxdigit iswxdigit
555 #define wxTolower towlower
556 #define wxToupper towupper
558 /* string.h functions (wchar.h) */
559 #define wxStrcat wcscat
560 #define wxStrchr wcschr
561 #define wxStrcmp wcscmp
562 #define wxStrcoll wcscoll
563 #define wxStrcpy wcscpy
564 #define wxStrcspn wcscspn
565 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
566 #define wxStrncat wcsncat
567 #define wxStrncmp wcsncmp
568 #define wxStrncpy wcsncpy
569 #define wxStrpbrk wcspbrk
570 #define wxStrrchr wcsrchr
571 #define wxStrspn wcsspn
572 #define wxStrstr wcsstr
573 #define wxStrtod wcstod
574 #define wxStrtol wcstol
575 #define wxStrtoul wcstoul
576 #define wxStrxfrm wcsxfrm
578 #define wxFgetc fgetwc
579 #define wxFgetchar fgetwchar
580 #define wxFgets fgetws
581 #define wxFputc fputwc
582 #define wxFputchar fputwchar
584 #define wxGetchar getwchar
586 #define wxUngetc ungetwc
588 #define wxNEED_PRINTF_CONVERSION
591 #define wxPutchar putwchar
592 #define wxFputs fputws
594 /* stdio.h functions */
596 #define wxNEED_WX_STDIO_H
598 /* stdlib.h functions */
600 #define wxNEED_WX_STDLIB_H
605 #define wxGetenv(a) ((wxChar*)NULL)
606 #define wxSystem(a) ((int)NULL)
608 /* time.h functions */
609 #define wxAsctime wasciitime
610 #define wxCtime wctime
611 /* #define wxStrftime wcsftime */
613 #define wxNEED_WX_TIME_H
614 #else /* !metrowerks for apple */
615 #error "Please define wide character functions for your environment"
621 /* ctype.h functions */
622 #define wxIsalnum isalnum
623 #define wxIsalpha isalpha
624 #define wxIscntrl iscntrl
625 #define wxIsdigit isdigit
626 #define wxIsgraph isgraph
627 #define wxIslower islower
628 #define wxIsprint isprint
629 #define wxIspunct ispunct
630 #define wxIsspace isspace
631 #define wxIsupper isupper
632 #define wxIsxdigit isxdigit
633 #define wxTolower tolower
634 #define wxToupper toupper
636 /* locale.h functons */
637 #define wxSetlocale setlocale
639 /* string.h functions */
640 #define wxStrcat strcat
641 #define wxStrchr strchr
642 #define wxStrcmp strcmp
643 #define wxStrcoll strcoll
644 #define wxStrcpy strcpy
645 #define wxStrcspn strcspn
647 /* wxStricmp and wxStrnicmp are defined below */
648 #define wxStrlen_ strlen /* used in wxStrlen inline function */
649 #define wxStrncat strncat
650 #define wxStrncmp strncmp
651 #define wxStrncpy strncpy
652 #define wxStrpbrk strpbrk
653 #define wxStrrchr strrchr
654 #define wxStrspn strspn
655 #define wxStrstr strstr
656 #define wxStrtod strtod
658 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
660 #define wxStrtol strtol
661 #define wxStrtoul strtoul
662 #define wxStrxfrm strxfrm
664 /* stdio.h functions */
665 #define wxFopen fopen
666 #define wxFreopen freopen
667 #define wxRemove remove
668 #define wxRename rename
670 #define wxPerror perror
671 #define wxTmpnam tmpnam
673 #define wxFgetc fgetc
674 #define wxFgetchar fgetchar
675 #define wxFgets fgets
676 #define wxFputc fputc
677 #define wxFputs fputs
678 #define wxFputchar fputchar
679 #define wxFprintf fprintf
680 #define wxFscanf fscanf
682 #define wxGetchar getchar
684 #define wxPrintf printf
686 #define wxPutchar putchar
688 #define wxScanf scanf
689 #define wxSprintf sprintf
690 #define wxSscanf sscanf
691 #define wxUngetc ungetc
692 #define wxVfprintf vfprintf
693 #define wxVprintf vprintf
694 #define wxVsscanf vsscanf
695 #define wxVsprintf vsprintf
697 /* stdlib.h functions */
701 #define wxGetenv getenv
702 #define wxSystem system
704 /* time.h functions */
705 #define wxAsctime asctime
706 #define wxCtime ctime
707 #define wxStrftime strftime
708 #endif /* Unicode/ASCII */
709 #endif /* TCHAR-aware compilers/the others */
712 various special cases
715 /* define wxStricmp and wxStrnicmp for various compilers */
717 /* note that in Unicode mode we definitely are going to need our own version */
718 #if !defined(wxStricmp) && !wxUSE_UNICODE
719 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
720 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
721 defined(__EMX__) || defined(__DJGPP__)
722 #define wxStricmp stricmp
723 #define wxStrnicmp strnicmp
724 #elif defined(__WXPALMOS__)
725 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
726 * quick hack should do until one can be written.
728 #define wxStricmp StrCaselessCompare
729 #define wxStrnicmp strnicmp
730 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
731 (defined(__MWERKS__) && defined(__INTEL__))
732 #define wxStricmp _stricmp
733 #define wxStrnicmp _strnicmp
734 #elif defined(__UNIX__) || defined(__GNUWIN32__)
735 #define wxStricmp strcasecmp
736 #define wxStrnicmp strncasecmp
737 /* #else -- use wxWidgets implementation */
739 #endif /* !defined(wxStricmp) */
741 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
742 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
743 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
746 #define wxWcslen wcslen
748 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
750 #endif /* wxUSE_WCHAR_T */
753 /* checks whether the passed in pointer is NULL and if the string is empty */
754 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
756 /* safe version of strlen() (returns 0 if passed NULL pointer) */
757 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
761 each of strdup() and wcsdup() may or may not be available but we need both
762 of them anyhow for wx/buffer.h so we define the missing one(s) in
763 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
764 defined -- if this is somehow not the case in some situations, please
765 correct that and not the lines here
768 #define wxStrdup wxStrdupW
770 #define wxStrdup wxStrdupA
774 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
777 /* printf() family saga */
780 For some systems [v]snprintf() exists in the system libraries but not in the
781 headers, so we need to declare it ourselves to be able to use it.
783 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
789 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
790 #endif /* !HAVE_VSNPRINTF_DECL */
792 #if defined(HAVE_SNPRINTF) && !defined(HAVE_SNPRINTF_DECL)
798 int snprintf(char *str
, size_t size
, const char *format
, ...);
799 #endif /* !HAVE_SNPRINTF_DECL */
801 /* Wrapper for vsnprintf if it's 3rd parameter is non-const. Note: the
802 * same isn't done for snprintf below, the builtin wxSnprintf_ is used
803 * instead since it's already a simple wrapper */
804 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
805 inline int wx_fixed_vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
)
807 return vsnprintf(str
, size
, (char*)format
, ap
);
812 First of all, we always want to define safe snprintf() function to be used
813 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
814 which we really need...), otherwise we implement it using our own printf()
817 We define function with a trailing underscore here because the real one is a
818 wrapper around it as explained below
822 #if defined(__MWERKS__)
823 #define HAVE_WCSRTOMBS 1
824 #define HAVE_VSWPRINTF 1
826 #if defined(__WATCOMC__)
827 #define wxVsnprintf_ _vsnwprintf
828 #define wxSnprintf_ _snwprintf
830 #if defined(HAVE__VSNWPRINTF)
831 #define wxVsnprintf_ _vsnwprintf
832 /* MinGW?MSVCRT has the wrong vswprintf */
833 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
834 #define wxVsnprintf_ vswprintf
837 /* all versions of CodeWarrior supported by wxWidgets apparently have */
838 /* both snprintf() and vsnprintf() */
839 #if defined(HAVE_SNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
840 #ifndef HAVE_BROKEN_SNPRINTF_DECL
841 #define wxSnprintf_ snprintf
844 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
845 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
846 #define wxVsnprintf_ wx_fixed_vsnprintf
848 #define wxVsnprintf_ vsnprintf
852 #endif /* wxVsnprintf_ not defined yet */
855 /* no [v]snprintf(), cook our own */
856 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
857 ...) ATTRIBUTE_PRINTF_3
;
860 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
865 In Unicode mode we need to have all standard functions such as wprintf() and
866 so on but not all systems have them so use our own implementations in this
869 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
870 #define wxNEED_WPRINTF
874 More Unicode complications: although both ANSI C and C++ define a number of
875 wide character functions such as wprintf(), not all environments have them.
876 Worse, those which do have different behaviours: under Windows, %s format
877 specifier changes its meaning in Unicode build and expects a Unicode string
878 while under Unix/POSIX it still means an ASCII string even for wprintf() and
879 %ls has to be used for wide strings.
881 We choose to always emulate Windows behaviour as more useful for us so even
882 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
886 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
888 we need to implement all wide character printf and scanf functions
889 either because we don't have them at all or because they don't have the
893 #include <stdio.h> /* for FILE */
895 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
896 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
897 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
898 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
899 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
900 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
901 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
902 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
903 int wxVprintf( const wxChar
*format
, va_list ap
);
904 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
905 #endif /* wxNEED_PRINTF_CONVERSION */
907 /* these 2 can be simply mapped to the versions with underscore at the end */
908 /* if we don't have to do the conversion */
910 However, if we don't have any vswprintf() at all we don't need to redefine
911 anything as our own wxVsnprintf_() already behaves as needed.
913 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
914 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
915 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
917 #define wxSnprintf wxSnprintf_
918 #define wxVsnprintf wxVsnprintf_
922 various functions which might not be available in libc and for which we
923 provide our own replacements in wxchar.cpp
926 /* ctype.h functions */
928 /* RN: Used only under OSX <= 10.2 currently */
929 #ifdef wxNEED_WX_CTYPE_H
930 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
931 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
932 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
933 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
934 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
935 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
936 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
937 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
938 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
939 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
940 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
941 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
942 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
943 #endif /* wxNEED_WX_CTYPE_H */
945 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
946 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
947 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
949 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
953 a few compilers don't have the (non standard but common) isascii function,
954 define it ourselves for them
957 #if defined(__MWERKS__)
958 #define wxNEED_ISASCII
959 #elif defined(_WIN32_WCE)
960 #if _WIN32_WCE <= 211
961 #define wxNEED_ISASCII
966 #ifdef wxNEED_ISASCII
967 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
971 #if _WIN32_WCE <= 211
972 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
974 #endif /* _WIN32_WCE */
977 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
978 initial versions of this header -- now it is too late to remove it so
979 although we fixed the function/macro name above, still provide the
980 backwards-compatible synonym.
982 #define wxIsctrl wxIscntrl
984 /* string.h functions */
986 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
987 #define wxNEED_STRDUP
988 #elif defined(__WXWINCE__)
989 #if _WIN32_WCE <= 211
990 #define wxNEED_STRDUP
996 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
999 /* RN: Used only under OSX <= 10.2 currently
1000 The __cplusplus ifdefs are messy, but they are required to build
1001 the regex library, since c does not support function overloading
1003 #ifdef wxNEED_WX_STRING_H
1007 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
1008 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
1009 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
1010 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
1011 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
1012 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
1013 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
1014 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
1015 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
1016 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
1017 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
1018 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
1019 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
1024 /* These functions use C++, so we can't c extern them */
1025 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
1026 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1027 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1028 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
1030 /* inlined versions */
1032 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
1033 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
1034 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
1035 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
1036 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
1037 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
1038 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
1039 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
1042 #endif /* wxNEED_WX_STRING_H */
1045 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
1049 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
1053 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
1057 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1061 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1066 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1067 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1071 /* stdio.h functions */
1072 #ifdef wxNEED_WX_STDIO_H
1074 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1075 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1076 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1077 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1079 /* *printf() family is handled separately */
1080 #endif /* wxNEED_WX_STDIO_H */
1083 /* stdlib.h functions */
1085 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1088 #ifdef wxNEED_WX_STDLIB_H
1089 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1090 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1091 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1092 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1096 /* time.h functions */
1097 #ifdef wxNEED_WX_TIME_H
1098 #if defined(__MWERKS__) && defined(macintosh)
1101 /*silent gabby compilers*/
1103 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1104 const wxChar
*fmt
, const struct tm
*tm
);
1105 #endif /* wxNEED_WX_TIME_H */
1109 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1113 /* missing functions in some WinCE versions */
1115 #if (_WIN32_WCE < 300)
1116 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1118 #endif /* _WIN32_WCE */
1120 /* multibyte to wide char conversion functions and macros */
1123 /* multibyte<->widechar conversion */
1124 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1125 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1128 #define wxMB2WX wxMB2WC
1129 #define wxWX2MB wxWC2MB
1130 #define wxWC2WX wxStrncpy
1131 #define wxWX2WC wxStrncpy
1133 #define wxMB2WX wxStrncpy
1134 #define wxWX2MB wxStrncpy
1135 #define wxWC2WX wxWC2MB
1136 #define wxWX2WC wxMB2WC
1138 #else /* !wxUSE_UNICODE */
1139 /* Why is this here?
1141 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1142 #define wxMB2WC wxStrncpy
1143 #define wxWC2MB wxStrncpy
1144 #define wxMB2WX wxStrncpy
1145 #define wxWX2MB wxStrncpy
1146 #define wxWC2WX wxWC2MB
1147 #define wxWX2WC wxMB2WC
1151 RN: The following are not normal versions of memcpy et al., rather
1152 these are either char or widechar versions depending on
1153 if unicode is used or not.
1159 // RN: We could do the usual tricky compiler detection here,
1160 // and use their variant (such as wmemchr, etc.). The problem
1161 // is that these functions are quite rare, even though they are
1162 // part of the current POSIX standard. In addition, most compilers
1163 // (including even MSC) inline them just like we do right in their
1167 #include <string.h> //for mem funcs
1169 //implement our own wmem variants
1170 inline wxChar
* wxTmemchr(const wxChar
* s
, wxChar c
, size_t l
)
1172 for(;l
&& *s
!= c
;--l
, ++s
) {}
1179 inline int wxTmemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1181 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1184 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1189 inline wxChar
* wxTmemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1191 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1194 inline wxChar
* wxTmemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1196 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1199 inline wxChar
* wxTmemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1201 wxChar
* szRet
= szOut
;
1209 #else /* !wxUSE_UNICODE */
1210 # define wxTmemchr memchr
1211 # define wxTmemcmp memcmp
1212 # define wxTmemcpy memcpy
1213 # define wxTmemmove memmove
1214 # define wxTmemset memset
1215 #endif /* wxUSE_UNICODE/!wxUSE_UNICODE */
1217 #endif /*__cplusplus*/
1220 #endif /* _WX_WXCHAR_H_ */