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 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
18 #pragma interface "wxchar.h"
21 #include "wx/defs.h" /* for wxUSE_UNICODE */
23 #if defined(HAVE_STRTOK_R) && defined(__DARWIN__) && defined(_MSL_USING_MW_C_HEADERS) && _MSL_USING_MW_C_HEADERS
24 char *strtok_r(char *, const char *, char **);
27 /* check whether we have wchar_t and which size it is if we do */
28 #if !defined(wxUSE_WCHAR_T)
30 #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || defined(__DARWIN__)
31 #define wxUSE_WCHAR_T 1
33 #define wxUSE_WCHAR_T 0
35 #elif defined(__GNUWIN32__) && !defined(__MINGW32__)
36 #define wxUSE_WCHAR_T 0
37 #elif defined(__WATCOMC__)
38 #define wxUSE_WCHAR_T 0
39 #elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
40 #define wxUSE_WCHAR_T 0
42 /* add additional compiler checks if this fails */
43 #define wxUSE_WCHAR_T 1
45 #endif /* !defined(wxUSE_WCHAR_T) */
47 /* Unicode support requires wchar_t */
48 #if wxUSE_UNICODE && !wxUSE_WCHAR_T
49 #error "wchar_t must be available in Unicode build"
53 Standard headers we need here.
55 NB: don't include any wxWidgets headers here because almost of them include
59 /* Required for wxPrintf() etc */
62 /* Almost all compiler have strdup(), but not quite all: CodeWarrior under Mac */
63 /* and VC++ for Windows CE don't provide it */
64 #if !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
65 /* use #define, not inline wrapper, as it is tested with #ifndef below */
66 #define wxStrdupA strdup
70 non Unix compilers which do have wchar.h (but not tchar.h which is included
71 below and which includes wchar.h anyhow).
73 Actually MinGW has tchar.h, but it does not include wchar.h
75 #if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__) || defined(__WATCOMC__)
80 #if defined(__MWERKS__) && !defined(__MACH__)
88 /* the current (as of Nov 2002) version of cygwin has a bug in its */
89 /* wchar.h -- there is no extern "C" around the declarations in it and */
90 /* this results in linking errors later; also, at least on some */
91 /* Cygwin versions, wchar.h requires sys/types.h */
93 #include <sys/types.h>
101 #if defined(__CYGWIN__) && defined(__cplusplus)
103 #endif /* Cygwin and C++ */
105 #elif defined(HAVE_WCSTR_H)
106 /* old compilers have relevant declarations here */
108 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
109 /* include stdlib.h for wchar_t */
111 #endif /* HAVE_WCHAR_H */
112 #endif /* wxUSE_WCHAR_T */
114 /* ---------------------------------------------------------------------------- */
115 /* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
116 /* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
117 /* the function mapping _tfoo() -> foo() or wfoo() */
118 /* ---------------------------------------------------------------------------- */
120 /* VC++ and BC++ starting with 5.2 have TCHAR support */
122 #define wxHAVE_TCHAR_SUPPORT
123 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
124 #define wxHAVE_TCHAR_SUPPORT
126 #elif defined(__WATCOMC__)
127 #define wxHAVE_TCHAR_SUPPORT
128 #elif defined(__DMC__)
129 #define wxHAVE_TCHAR_SUPPORT
130 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 ) && !defined(__WXPALMOS__)
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 */
150 #ifdef wxHAVE_TCHAR_SUPPORT
151 /* get TCHAR definition if we've got it */
154 /* we surely do have wchar_t if we have TCHAR */
155 #ifndef wxUSE_WCHAR_T
156 #define wxUSE_WCHAR_T 1
157 #endif /* !defined(wxUSE_WCHAR_T) */
159 /* and we also do have wcslen() */
163 #endif /* wxHAVE_TCHAR_SUPPORT */
165 /* ---------------------------------------------------------------------------- */
166 /* define wxChar type */
167 /* ---------------------------------------------------------------------------- */
169 /* TODO: define wxCharInt to be equal to either int or wint_t? */
173 typedef signed char wxSChar
;
174 typedef unsigned char wxUChar
;
176 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
177 /* signed/unsigned version of it which (a) makes sense to me (unlike */
178 /* char wchar_t is always unsigned) and (b) was how the previous */
179 /* definitions worked so keep it like this */
181 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
183 #if !defined(__WCHAR_TYPE__) || \
184 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
186 typedef wchar_t wxChar
;
187 typedef wchar_t wxSChar
;
188 typedef wchar_t wxUChar
;
189 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
190 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
191 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
192 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
193 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
194 /* have to define wxChar conditionally depending on detected */
195 /* compiler & compiler version. */
196 /* with old definition of wxChar. */
197 typedef __WCHAR_TYPE__ wxChar
;
198 typedef __WCHAR_TYPE__ wxSChar
;
199 typedef __WCHAR_TYPE__ wxUChar
;
200 #endif /* __WCHAR_TYPE__ */
201 #endif /* ASCII/Unicode */
203 /* ---------------------------------------------------------------------------- */
204 /* define _T() and related macros */
205 /* ---------------------------------------------------------------------------- */
207 /* BSD systems define _T() to be something different in ctype.h, override it */
208 #if defined(__FreeBSD__) || defined(__DARWIN__)
213 /* could already be defined by tchar.h (it's quasi standard) */
219 #endif /* ASCII/Unicode */
220 #endif /* !defined(_T) */
222 /* although global macros with such names are normally bad, we want to have */
223 /* another name for _T() which should be used to avoid confusion between _T() */
224 /* and _() in wxWidgets sources */
227 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
229 #define __XFILE__(x) wxT(x)
230 #define __TFILE__ __XFILE__(__FILE__)
234 #define __XDATE__(x) wxT(x)
235 #define __TDATE__ __XDATE__(__DATE__)
239 #define __XTIME__(x) wxT(x)
240 #define __TTIME__ __XTIME__(__TIME__)
244 define wxFoo() function for each standard foo() function whose signature
245 (exceptionally including the return type) includes any mention of char:
246 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
247 the same signature but with char replaced by wxChar which allows us to use
248 it in Unicode build as well
251 #ifdef wxHAVE_TCHAR_SUPPORT
254 #if defined(__WATCOMC__) && defined(UNICODE)
255 #define WXWCHAR_T_CAST(c) (wint_t)(c)
257 #define WXWCHAR_T_CAST(c) c
260 /* ctype.h functions */
261 #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
262 #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
263 #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
264 #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
265 #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
266 #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
267 #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
268 #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
269 #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
270 #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
271 #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
274 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
275 signed chars < 0, so "fix" it here.
277 #define wxTolower(c) _totlower((wxUChar)(c))
278 #define wxToupper(c) _totupper((wxUChar)(c))
280 /* locale.h functons */
281 #define wxSetlocale _tsetlocale
283 /* string.h functions */
284 #define wxStrcat _tcscat
285 #define wxStrchr _tcschr
286 #define wxStrcmp _tcscmp
287 #define wxStrcoll _tcscoll
288 #define wxStrcpy _tcscpy
289 #define wxStrcspn _tcscspn
290 #define wxStrdupW _wcsdup /* notice the 'W'! */
291 #define wxStrftime _tcsftime
292 #define wxStricmp _tcsicmp
293 #define wxStrnicmp _tcsnicmp
294 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
295 #define wxStrncat _tcsncat
296 #define wxStrncmp _tcsncmp
297 #define wxStrncpy _tcsncpy
298 #define wxStrpbrk _tcspbrk
299 #define wxStrrchr _tcsrchr
300 #define wxStrspn _tcsspn
301 #define wxStrstr _tcsstr
302 #define wxStrtod _tcstod
303 #define wxStrtol _tcstol
304 #define wxStrtoul _tcstoul
305 #define wxStrxfrm _tcsxfrm
307 /* stdio.h functions */
308 #define wxFgetc _fgettc
309 #define wxFgetchar _fgettchar
310 #define wxFgets _fgetts
311 #if wxUSE_UNICODE_MSLU
312 #define wxFopen wxMSLU__tfopen
314 #define wxFopen _tfopen
316 #define wxFputc _fputtc
317 #define wxFputchar _fputtchar
318 #define wxFprintf _ftprintf
319 #define wxFputs _fputts
320 #define wxFreopen _tfreopen
321 #define wxFscanf _ftscanf
322 #define wxGetc _gettc
323 #define wxGetchar _gettchar
324 #define wxGets _getts
325 #define wxPerror _tperror
326 #define wxPrintf _tprintf
327 #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
328 #define wxPutchar _puttchar
329 #define wxPuts _putts
330 #define wxScanf _tscanf
333 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
334 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
336 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
337 #define wxSprintf sprintf
340 #define wxSprintf _stprintf
343 #define wxSscanf _stscanf
344 #define wxTmpnam _ttmpnam
345 #define wxUngetc _tungetc
346 #define wxVfprintf _vftprintf
347 #define wxVprintf _vtprintf
348 #define wxVsscanf _vstscanf
349 #define wxVsprintf _vstprintf
351 /* special case: not all TCHAR-aware compilers have those */
352 #if defined(__VISUALC__) || \
353 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
354 #define wxVsnprintf_ _vsntprintf
355 #define wxSnprintf_ _sntprintf
358 /* special case: these functions are missing under Win9x with Unicows so we */
359 /* have to implement them ourselves */
360 #if wxUSE_UNICODE_MSLU
361 #define wxRemove wxMSLU__tremove
362 #define wxRename wxMSLU__trename
365 /* carefully: wxRemove() must return 0 on success while DeleteFile()
366 returns 0 on error, so don't just define one as the other */
367 int wxRemove(const wxChar
*path
);
369 #define wxRemove _tremove
370 #define wxRename _trename
374 /* stdlib.h functions */
377 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
378 /* there are no env vars at all under CE, so no _tgetenv neither */
380 /* can't define as inline function as this is a C file... */
381 #define wxGetenv(name) ((wxChar *)NULL)
383 #define wxGetenv _tgetenv
385 #define wxSystem _tsystem
387 /* time.h functions */
388 #define wxAsctime _tasctime
389 #define wxCtime _tctime
391 #define wxMbstowcs mbstowcs
392 #define wxWcstombs wcstombs
393 #else /* !TCHAR-aware compilers */
395 #if !defined(__MWERKS__) && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
396 /* even though they are defined and "implemented", they are bad and just
397 stubs so we need our own - we need these even in ANSI builds!! */
398 WXDLLIMPEXP_BASE
size_t wxMbstowcs (wchar_t *, const char *, size_t);
399 WXDLLIMPEXP_BASE
size_t wxWcstombs (char *, const wchar_t *, size_t);
401 #define wxMbstowcs mbstowcs
402 #define wxWcstombs wcstombs
405 /* No UNICODE in the c library except wchar_t typedef on mac OSX 10.2 and less - roll our own */
406 #if !defined(__MWERKS__) && wxUSE_UNICODE && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
408 /* we need everything! */
409 #define wxNEED_WX_STRING_H
410 #define wxNEED_WX_CTYPE_H
412 #define wxFgetchar(c) wxFgetc(c, stdin)
413 #define wxFputc wxPutc
414 #define wxFputchar(c) wxPutc(c, stdout)
415 #define wxGetc wxFgetc
416 #define wxGetchar(c) wxFgetc(c, stdin)
423 #define wxNEED_UNGETC
429 int wxFputs(const wxChar
*ch
, FILE *stream
);
430 int wxPuts(const wxChar
*ws
);
431 int wxPutc(wxChar ch
, FILE *stream
);
436 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
441 #define wxPutchar(wch) wxPutc(wch, stdout)
443 #define wxNEED_PRINTF_CONVERSION
444 #define wxNEED_WX_STDIO_H
445 #define wxNEED_WX_STDLIB_H
446 #define wxNEED_WX_TIME_H
451 /* this is probably glibc-specific */
452 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
453 /* ctype.h functions (wctype.h) */
454 #define wxIsalnum iswalnum
455 #define wxIsalpha iswalpha
456 #define wxIscntrl iswcntrl
457 #define wxIsdigit iswdigit
458 #define wxIsgraph iswgraph
459 #define wxIslower iswlower
460 #define wxIsprint iswprint
461 #define wxIspunct iswpunct
462 #define wxIsspace iswspace
463 #define wxIsupper iswupper
464 #define wxIsxdigit iswxdigit
466 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
467 /* /usr/include/wctype.h incorrectly declares translations */
468 /* tables which provokes tons of compile-time warnings -- try */
469 /* to correct this */
470 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
471 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
472 #else /* !glibc 2.0 */
473 #define wxTolower towlower
474 #define wxToupper towupper
475 #endif /* gcc/!gcc */
477 /* string.h functions (wchar.h) */
478 #define wxStrcat wcscat
479 #define wxStrchr wcschr
480 #define wxStrcmp wcscmp
481 #define wxStrcoll wcscoll
482 #define wxStrcpy wcscpy
483 #define wxStrcspn wcscspn
484 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
485 #define wxStrncat wcsncat
486 #define wxStrncmp wcsncmp
487 #define wxStrncpy wcsncpy
488 #define wxStrpbrk wcspbrk
489 #define wxStrrchr wcsrchr
490 #define wxStrspn wcsspn
491 #define wxStrstr wcsstr
492 #define wxStrtod wcstod
493 #define wxStrtol wcstol
494 #define wxStrtoul wcstoul
495 #define wxStrxfrm wcsxfrm
497 #define wxFgetc fgetwc
498 #define wxFgetchar fgetwchar
499 #define wxFgets fgetws
500 #define wxFputc fputwc
501 #define wxFputchar fputwchar
503 #define wxGetchar getwchar
505 #define wxUngetc ungetwc
508 #define wxFputs fputws
512 int wxFputs(const wxChar
*ch
, FILE *stream
);
520 int wxPutc(wxChar ch
, FILE *stream
);
524 #define wxPutchar wputchar
526 #define wxPutchar(wch) wxPutc(wch, stdout)
533 int wxPuts(const wxChar
*ws
);
536 /* we need %s to %ls conversion for printf and scanf etc */
537 #define wxNEED_PRINTF_CONVERSION
539 /* glibc doesn't have wide char equivalents of the other stuff so */
540 /* use our own versions */
541 #define wxNEED_WX_STDIO_H
542 #define wxNEED_WX_STDLIB_H
543 #define wxNEED_WX_TIME_H
544 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
545 /* ctype.h functions (wctype.h) */
546 #define wxIsalnum iswalnum
547 #define wxIsalpha iswalpha
548 #define wxIscntrl iswcntrl
549 #define wxIsdigit iswdigit
550 #define wxIsgraph iswgraph
551 #define wxIslower iswlower
552 #define wxIsprint iswprint
553 #define wxIspunct iswpunct
554 #define wxIsspace iswspace
555 #define wxIsupper iswupper
556 #define wxIsxdigit iswxdigit
557 #define wxTolower towlower
558 #define wxToupper towupper
560 /* string.h functions (wchar.h) */
561 #define wxStrcat wcscat
562 #define wxStrchr wcschr
563 #define wxStrcmp wcscmp
564 #define wxStrcoll wcscoll
565 #define wxStrcpy wcscpy
566 #define wxStrcspn wcscspn
567 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
568 #define wxStrncat wcsncat
569 #define wxStrncmp wcsncmp
570 #define wxStrncpy wcsncpy
571 #define wxStrpbrk wcspbrk
572 #define wxStrrchr wcsrchr
573 #define wxStrspn wcsspn
574 #define wxStrstr wcsstr
575 #define wxStrtod wcstod
576 #define wxStrtol wcstol
577 #define wxStrtoul wcstoul
578 #define wxStrxfrm wcsxfrm
580 #define wxFgetc fgetwc
581 #define wxFgetchar fgetwchar
582 #define wxFgets fgetws
583 #define wxFputc fputwc
584 #define wxFputchar fputwchar
586 #define wxGetchar getwchar
588 #define wxUngetc ungetwc
590 #define wxNEED_PRINTF_CONVERSION
593 #define wxPutchar putwchar
594 #define wxFputs fputws
596 /* stdio.h functions */
598 #define wxNEED_WX_STDIO_H
600 /* stdlib.h functions */
602 #define wxNEED_WX_STDLIB_H
607 #define wxGetenv(a) ((wxChar*)NULL)
608 #define wxSystem(a) ((int)NULL)
610 /* time.h functions */
611 #define wxAsctime wasciitime
612 #define wxCtime wctime
613 /* #define wxStrftime wcsftime */
615 #define wxNEED_WX_TIME_H
616 #else /* !metrowerks for apple */
617 #error "Please define wide character functions for your environment"
623 /* ctype.h functions */
624 #define wxIsalnum isalnum
625 #define wxIsalpha isalpha
626 #define wxIscntrl iscntrl
627 #define wxIsdigit isdigit
628 #define wxIsgraph isgraph
629 #define wxIslower islower
630 #define wxIsprint isprint
631 #define wxIspunct ispunct
632 #define wxIsspace isspace
633 #define wxIsupper isupper
634 #define wxIsxdigit isxdigit
635 #define wxTolower tolower
636 #define wxToupper toupper
638 /* locale.h functons */
639 #define wxSetlocale setlocale
641 /* string.h functions */
642 #define wxStrcat strcat
643 #define wxStrchr strchr
644 #define wxStrcmp strcmp
645 #define wxStrcoll strcoll
646 #define wxStrcpy strcpy
647 #define wxStrcspn strcspn
649 /* wxStricmp and wxStrnicmp are defined below */
650 #define wxStrlen_ strlen /* used in wxStrlen inline function */
651 #define wxStrncat strncat
652 #define wxStrncmp strncmp
653 #define wxStrncpy strncpy
654 #define wxStrpbrk strpbrk
655 #define wxStrrchr strrchr
656 #define wxStrspn strspn
657 #define wxStrstr strstr
658 #define wxStrtod strtod
660 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
662 #define wxStrtol strtol
663 #define wxStrtoul strtoul
664 #define wxStrxfrm strxfrm
666 /* stdio.h functions */
667 #define wxFopen fopen
668 #define wxFreopen freopen
669 #define wxRemove remove
670 #define wxRename rename
672 #define wxPerror perror
673 #define wxTmpnam tmpnam
675 #define wxFgetc fgetc
676 #define wxFgetchar fgetchar
677 #define wxFgets fgets
678 #define wxFputc fputc
679 #define wxFputs fputs
680 #define wxFputchar fputchar
681 #define wxFprintf fprintf
682 #define wxFscanf fscanf
684 #define wxGetchar getchar
686 #define wxPrintf printf
688 #define wxPutchar putchar
690 #define wxScanf scanf
691 #define wxSprintf sprintf
692 #define wxSscanf sscanf
693 #define wxUngetc ungetc
694 #define wxVfprintf vfprintf
695 #define wxVprintf vprintf
696 #define wxVsscanf vsscanf
697 #define wxVsprintf vsprintf
699 /* stdlib.h functions */
703 #define wxGetenv getenv
704 #define wxSystem system
706 /* time.h functions */
707 #define wxAsctime asctime
708 #define wxCtime ctime
709 #define wxStrftime strftime
710 #endif /* Unicode/ASCII */
711 #endif /* TCHAR-aware compilers/the others */
714 various special cases
717 /* define wxStricmp and wxStrnicmp for various compilers */
719 /* note that in Unicode mode we definitely are going to need our own version */
720 #if !defined(wxStricmp) && !wxUSE_UNICODE
721 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
722 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
723 defined(__EMX__) || defined(__DJGPP__)
724 #define wxStricmp stricmp
725 #define wxStrnicmp strnicmp
726 #elif defined(__WXPALMOS__)
727 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
728 * quick hack should do until one can be written.
730 #define wxStricmp StrCaselessCompare
731 #define wxStrnicmp strnicmp
732 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
733 (defined(__MWERKS__) && defined(__INTEL__))
734 #define wxStricmp _stricmp
735 #define wxStrnicmp _strnicmp
736 #elif defined(__UNIX__) || defined(__GNUWIN32__)
737 #define wxStricmp strcasecmp
738 #define wxStrnicmp strncasecmp
739 /* #else -- use wxWidgets implementation */
741 #endif /* !defined(wxStricmp) */
743 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
744 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
745 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
748 #define wxWcslen wcslen
750 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
752 #endif /* wxUSE_WCHAR_T */
755 /* checks whether the passed in pointer is NULL and if the string is empty */
756 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
758 /* safe version of strlen() (returns 0 if passed NULL pointer) */
759 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
763 each of strdup() and wcsdup() may or may not be available but we need both
764 of them anyhow for wx/buffer.h so we define the missing one(s) in
765 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
766 defined -- if this is somehow not the case in some situations, please
767 correct that and not the lines here
770 #define wxStrdup wxStrdupW
772 #define wxStrdup wxStrdupA
776 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
779 /* printf() family saga */
782 For some systems vsnprintf() exists in the system libraries but not in the
783 headers, so we need to declare it ourselves to be able to use it.
785 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
791 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
792 #endif /* !HAVE_VSNPRINTF_DECL */
795 First of all, we always want to define safe snprintf() function to be used
796 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
797 which we really need...), otherwise we implement it using our own printf()
800 We define function with a trailing underscore here because the real one is a
801 wrapper around it as explained below
805 #if defined(__MWERKS__)
806 #define HAVE_WCSRTOMBS 1
807 #define HAVE_VSWPRINTF 1
809 #if defined(__WATCOMC__)
810 #define wxVsnprintf_ _vsnwprintf
811 #define wxSnprintf_ _snwprintf
813 #if defined(HAVE__VSNWPRINTF)
814 #define wxVsnprintf_ _vsnwprintf
815 /* MinGW?MSVCRT has the wrong vswprintf */
816 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
817 #define wxVsnprintf_ vswprintf
820 /* all versions of CodeWarrior supported by wxWidgets apparently have */
822 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
823 /* assume we have snprintf() too if we have vsnprintf() */
824 #define wxVsnprintf_ vsnprintf
825 #define wxSnprintf_ snprintf
828 #endif /* wxVsnprintf_ not defined yet */
831 /* no [v]snprintf(), cook our own */
832 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
833 ...) ATTRIBUTE_PRINTF_3
;
836 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
841 In Unicode mode we need to have all standard functions such as wprintf() and
842 so on but not all systems have them so use our own implementations in this
845 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
846 #define wxNEED_WPRINTF
850 More Unicode complications: although both ANSI C and C++ define a number of
851 wide character functions such as wprintf(), not all environments have them.
852 Worse, those which do have different behaviours: under Windows, %s format
853 specifier changes its meaning in Unicode build and expects a Unicode string
854 while under Unix/POSIX it still means an ASCII string even for wprintf() and
855 %ls has to be used for wide strings.
857 We choose to always emulate Windows behaviour as more useful for us so even
858 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
862 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
864 we need to implement all wide character printf and scanf functions
865 either because we don't have them at all or because they don't have the
869 #include <stdio.h> /* for FILE */
871 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
872 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
873 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
874 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
875 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
876 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
877 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
878 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
879 int wxVprintf( const wxChar
*format
, va_list ap
);
880 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
881 #endif /* wxNEED_PRINTF_CONVERSION */
883 /* these 2 can be simply mapped to the versions with underscore at the end */
884 /* if we don't have to do the conversion */
886 However, if we don't have any vswprintf() at all we don't need to redefine
887 anything as our own wxVsnprintf_() already behaves as needed.
889 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
890 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
891 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
893 #define wxSnprintf wxSnprintf_
894 #define wxVsnprintf wxVsnprintf_
898 various functions which might not be available in libc and for which we
899 provide our own replacements in wxchar.cpp
902 /* ctype.h functions */
904 /* RN: Used only under OSX <= 10.2 currently */
905 #ifdef wxNEED_WX_CTYPE_H
906 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
907 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
908 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
909 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
910 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
911 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
912 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
913 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
914 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
915 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
916 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
917 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
918 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
919 #endif /* wxNEED_WX_CTYPE_H */
921 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
922 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
923 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
925 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
929 a few compilers don't have the (non standard but common) isascii function,
930 define it ourselves for them
933 #if defined(__MWERKS__)
934 #define wxNEED_ISASCII
935 #elif defined(_WIN32_WCE)
936 #if _WIN32_WCE <= 211
937 #define wxNEED_ISASCII
942 #ifdef wxNEED_ISASCII
943 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
947 #if _WIN32_WCE <= 211
948 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
950 #endif /* _WIN32_WCE */
953 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
954 initial versions of this header -- now it is too late to remove it so
955 although we fixed the function/macro name above, still provide the
956 backwards-compatible synonym.
958 #define wxIsctrl wxIscntrl
960 /* string.h functions */
962 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
963 #define wxNEED_STRDUP
964 #elif defined(__WXWINCE__)
965 #if _WIN32_WCE <= 211
966 #define wxNEED_STRDUP
972 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
975 /* RN: Used only under OSX <= 10.2 currently
976 The __cplusplus ifdefs are messy, but they are required to build
977 the regex library, since c does not support function overloading
979 #ifdef wxNEED_WX_STRING_H
983 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
984 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
985 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
986 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
987 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
988 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
989 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
990 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
991 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
992 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
993 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
994 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
995 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
1000 /* These functions use C++, so we can't c extern them */
1001 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
1002 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1003 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1004 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
1006 /* inlined versions */
1008 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
1009 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
1010 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
1011 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
1012 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
1013 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
1014 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
1015 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
1018 #endif /* wxNEED_WX_STRING_H */
1021 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
1025 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
1029 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
1033 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1037 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1042 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1043 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1047 /* stdio.h functions */
1048 #ifdef wxNEED_WX_STDIO_H
1050 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1051 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1052 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1053 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1055 /* *printf() family is handled separately */
1056 #endif /* wxNEED_WX_STDIO_H */
1059 /* stdlib.h functions */
1061 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1064 #ifdef wxNEED_WX_STDLIB_H
1065 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1066 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1067 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1068 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1072 /* time.h functions */
1073 #ifdef wxNEED_WX_TIME_H
1074 #if defined(__MWERKS__) && defined(macintosh)
1077 /*silent gabby compilers*/
1079 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1080 const wxChar
*fmt
, const struct tm
*tm
);
1081 #endif /* wxNEED_WX_TIME_H */
1085 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1089 /* missing functions in some WinCE versions */
1091 #if (_WIN32_WCE < 300)
1092 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1094 #endif /* _WIN32_WCE */
1096 /* multibyte to wide char conversion functions and macros */
1099 /* multibyte<->widechar conversion */
1100 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1101 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1104 #define wxMB2WX wxMB2WC
1105 #define wxWX2MB wxWC2MB
1106 #define wxWC2WX wxStrncpy
1107 #define wxWX2WC wxStrncpy
1109 #define wxMB2WX wxStrncpy
1110 #define wxWX2MB wxStrncpy
1111 #define wxWC2WX wxWC2MB
1112 #define wxWX2WC wxMB2WC
1114 #else /* !wxUSE_UNICODE */
1115 /* Why is this here?
1117 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1118 #define wxMB2WC wxStrncpy
1119 #define wxWC2MB wxStrncpy
1120 #define wxMB2WX wxStrncpy
1121 #define wxWX2MB wxStrncpy
1122 #define wxWC2WX wxWC2MB
1123 #define wxWX2WC wxMB2WC
1127 RN: The following are not normal versions of memcpy et al., rather
1128 these are either char or widechar versions depending on
1129 if unicode is used or not.
1135 // RN: We could do the usual tricky compiler detection here,
1136 // and use their variant (such as wmemchr, etc.). The problem
1137 // is that these functions are quite rare, even though they are
1138 // part of the current POSIX standard. In addition, most compilers
1139 // (including even MSC) inline them just like we do right in their
1143 #include <string.h> //for mem funcs
1145 //implement our own wmem variants
1146 inline wxChar
* wxTmemchr(const wxChar
* s
, wxChar c
, size_t l
)
1148 for(;l
&& *s
!= c
;--l
, ++s
) {}
1155 inline int wxTmemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1157 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1160 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1165 inline wxChar
* wxTmemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1167 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1170 inline wxChar
* wxTmemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1172 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1175 inline wxChar
* wxTmemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1177 wxChar
* szRet
= szOut
;
1185 #else //!wxUSE_UNICODE
1186 # define wxTmemchr memchr
1187 # define wxTmemcmp memcmp
1188 # define wxTmemcpy memcpy
1189 # define wxTmemmove memmove
1190 # define wxTmemset memset
1193 #endif /*__cplusplus*/
1196 #endif /* _WX_WXCHAR_H_ */