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 wxWidgets dev team
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 /* 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(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 ) && !defined(__WXPALMOS__)
127 #define wxHAVE_TCHAR_SUPPORT
131 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
132 /* VZ: the old VisualAge definitions were completely wrong and had no */
133 /* chance at all to work in Unicode build anyhow so let's pretend that */
134 /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
135 /* "0 &&" above) until someone really has time to delve into Unicode */
136 /* issues under OS/2 */
138 /* VisualAge 4.0+ supports TCHAR */
139 #define wxHAVE_TCHAR_SUPPORT
140 #endif /* compilers with (good) TCHAR support */
146 #ifdef wxHAVE_TCHAR_SUPPORT
147 /* get TCHAR definition if we've got it */
150 /* we surely do have wchar_t if we have TCHAR */
151 #ifndef wxUSE_WCHAR_T
152 #define wxUSE_WCHAR_T 1
153 #endif /* !defined(wxUSE_WCHAR_T) */
155 /* and we also do have wcslen() */
159 #endif /* wxHAVE_TCHAR_SUPPORT */
161 /* ---------------------------------------------------------------------------- */
162 /* define wxChar type */
163 /* ---------------------------------------------------------------------------- */
165 /* TODO: define wxCharInt to be equal to either int or wint_t? */
169 typedef signed char wxSChar
;
170 typedef unsigned char wxUChar
;
172 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
173 /* signed/unsigned version of it which (a) makes sense to me (unlike */
174 /* char wchar_t is always unsigned) and (b) was how the previous */
175 /* definitions worked so keep it like this */
177 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
179 #if !defined(__WCHAR_TYPE__) || \
180 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
182 typedef wchar_t wxChar
;
183 typedef wchar_t wxSChar
;
184 typedef wchar_t wxUChar
;
185 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
186 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
187 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
188 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
189 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
190 /* have to define wxChar conditionally depending on detected */
191 /* compiler & compiler version. */
192 /* with old definition of wxChar. */
193 typedef __WCHAR_TYPE__ wxChar
;
194 typedef __WCHAR_TYPE__ wxSChar
;
195 typedef __WCHAR_TYPE__ wxUChar
;
196 #endif /* __WCHAR_TYPE__ */
197 #endif /* ASCII/Unicode */
199 /* ---------------------------------------------------------------------------- */
200 /* define _T() and related macros */
201 /* ---------------------------------------------------------------------------- */
203 /* BSD systems define _T() to be something different in ctype.h, override it */
204 #if defined(__FreeBSD__) || defined(__DARWIN__)
209 /* could already be defined by tchar.h (it's quasi standard) */
215 #endif /* ASCII/Unicode */
216 #endif /* !defined(_T) */
218 /* although global macros with such names are normally bad, we want to have */
219 /* another name for _T() which should be used to avoid confusion between _T() */
220 /* and _() in wxWidgets sources */
223 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
225 #define __XFILE__(x) wxT(x)
226 #define __TFILE__ __XFILE__(__FILE__)
230 #define __XDATE__(x) wxT(x)
231 #define __TDATE__ __XDATE__(__DATE__)
235 #define __XTIME__(x) wxT(x)
236 #define __TTIME__ __XTIME__(__TIME__)
240 define wxFoo() function for each standard foo() function whose signature
241 (exceptionally including the return type) includes any mention of char:
242 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
243 the same signature but with char replaced by wxChar which allows us to use
244 it in Unicode build as well
247 #ifdef wxHAVE_TCHAR_SUPPORT
250 #if defined(__WATCOMC__) && defined(UNICODE)
251 #define WXWCHAR_T_CAST(c) (wint_t)(c)
253 #define WXWCHAR_T_CAST(c) c
256 /* ctype.h functions */
257 #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
258 #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
259 #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
260 #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
261 #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
262 #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
263 #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
264 #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
265 #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
266 #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
267 #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
270 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
271 signed chars < 0, so "fix" it here.
273 #define wxTolower(c) _totlower((wxUChar)(c))
274 #define wxToupper(c) _totupper((wxUChar)(c))
276 /* locale.h functons */
277 #define wxSetlocale _tsetlocale
279 /* string.h functions */
280 #define wxStrcat _tcscat
281 #define wxStrchr _tcschr
282 #define wxStrcmp _tcscmp
283 #define wxStrcoll _tcscoll
284 #define wxStrcpy _tcscpy
285 #define wxStrcspn _tcscspn
286 #define wxStrdupW _wcsdup /* notice the 'W'! */
287 #define wxStrftime _tcsftime
288 #define wxStricmp _tcsicmp
289 #define wxStrnicmp _tcsnicmp
290 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
291 #define wxStrncat _tcsncat
292 #define wxStrncmp _tcsncmp
293 #define wxStrncpy _tcsncpy
294 #define wxStrpbrk _tcspbrk
295 #define wxStrrchr _tcsrchr
296 #define wxStrspn _tcsspn
297 #define wxStrstr _tcsstr
298 #define wxStrtod _tcstod
299 #define wxStrtol _tcstol
300 #define wxStrtoul _tcstoul
301 #define wxStrxfrm _tcsxfrm
303 /* stdio.h functions */
304 #define wxFgetc _fgettc
305 #define wxFgetchar _fgettchar
306 #define wxFgets _fgetts
307 #if wxUSE_UNICODE_MSLU
308 #define wxFopen wxMSLU__tfopen
310 #define wxFopen _tfopen
312 #define wxFputc _fputtc
313 #define wxFputchar _fputtchar
314 #define wxFprintf _ftprintf
315 #define wxFputs _fputts
316 #define wxFreopen _tfreopen
317 #define wxFscanf _ftscanf
318 #define wxGetc _gettc
319 #define wxGetchar _gettchar
320 #define wxGets _getts
321 #define wxPerror _tperror
322 #define wxPrintf _tprintf
323 #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
324 #define wxPutchar _puttchar
325 #define wxPuts _putts
326 #define wxScanf _tscanf
329 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
330 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
332 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
333 #define wxSprintf sprintf
336 #define wxSprintf _stprintf
339 #define wxSscanf _stscanf
340 #define wxTmpnam _ttmpnam
341 #define wxUngetc _tungetc
342 #define wxVfprintf _vftprintf
343 #define wxVprintf _vtprintf
344 #define wxVsscanf _vstscanf
345 #define wxVsprintf _vstprintf
347 /* special case: not all TCHAR-aware compilers have those */
348 #if defined(__VISUALC__) || \
349 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
350 #define wxVsnprintf_ _vsntprintf
351 #define wxSnprintf_ _sntprintf
354 /* special case: these functions are missing under Win9x with Unicows so we */
355 /* have to implement them ourselves */
356 #if wxUSE_UNICODE_MSLU
357 #define wxRemove wxMSLU__tremove
358 #define wxRename wxMSLU__trename
361 #define wxRemove DeleteFile
363 #define wxRemove _tremove
364 #define wxRename _trename
368 /* stdlib.h functions */
371 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
372 /* there are no env vars at all under CE, so no _tgetenv neither */
374 /* can't define as inline function as this is a C file... */
375 #define wxGetenv(name) ((wxChar *)NULL)
377 #define wxGetenv _tgetenv
379 #define wxSystem _tsystem
381 /* time.h functions */
382 #define wxAsctime _tasctime
383 #define wxCtime _tctime
384 #else /* !TCHAR-aware compilers */
386 #if !defined(__MWERKS__) && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
387 /* even though they are defined and "implemented", they are bad and just
388 stubs so we need our own - we need these even in ANSI builds!! */
389 #define mbstowcs wxInternalMbstowcs
390 #define wcstombs wxInternalWcstombs
392 WXDLLIMPEXP_BASE
size_t wxInternalMbstowcs (wchar_t *, const char *, size_t);
393 WXDLLIMPEXP_BASE
size_t wxInternalWcstombs (char *, const wchar_t *, size_t);
396 /* No UNICODE in the c library except wchar_t typedef on mac OSX 10.2 and less - roll our own */
397 #if !defined(__MWERKS__) && wxUSE_UNICODE && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
399 /* we need everything! */
400 #define wxNEED_WX_STRING_H
401 #define wxNEED_WX_CTYPE_H
403 #define wxFgetchar(c) wxFgetc(c, stdin)
404 #define wxFputc wxPutc
405 #define wxFputchar(c) wxPutc(c, stdout)
406 #define wxGetc wxFgetc
407 #define wxGetchar(c) wxFgetc(c, stdin)
414 #define wxNEED_UNGETC
420 int wxFputs(const wxChar
*ch
, FILE *stream
);
421 int wxPuts(const wxChar
*ws
);
422 int wxPutc(wxChar ch
, FILE *stream
);
427 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
432 #define wxPutchar(wch) wxPutc(wch, stdout)
434 #define wxNEED_PRINTF_CONVERSION
435 #define wxNEED_WX_STDIO_H
436 #define wxNEED_WX_STDLIB_H
437 #define wxNEED_WX_TIME_H
442 /* this is probably glibc-specific */
443 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
444 /* ctype.h functions (wctype.h) */
445 #define wxIsalnum iswalnum
446 #define wxIsalpha iswalpha
447 #define wxIscntrl iswcntrl
448 #define wxIsdigit iswdigit
449 #define wxIsgraph iswgraph
450 #define wxIslower iswlower
451 #define wxIsprint iswprint
452 #define wxIspunct iswpunct
453 #define wxIsspace iswspace
454 #define wxIsupper iswupper
455 #define wxIsxdigit iswxdigit
457 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
458 /* /usr/include/wctype.h incorrectly declares translations */
459 /* tables which provokes tons of compile-time warnings -- try */
460 /* to correct this */
461 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
462 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
463 #else /* !glibc 2.0 */
464 #define wxTolower towlower
465 #define wxToupper towupper
466 #endif /* gcc/!gcc */
468 /* string.h functions (wchar.h) */
469 #define wxStrcat wcscat
470 #define wxStrchr wcschr
471 #define wxStrcmp wcscmp
472 #define wxStrcoll wcscoll
473 #define wxStrcpy wcscpy
474 #define wxStrcspn wcscspn
475 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
476 #define wxStrncat wcsncat
477 #define wxStrncmp wcsncmp
478 #define wxStrncpy wcsncpy
479 #define wxStrpbrk wcspbrk
480 #define wxStrrchr wcsrchr
481 #define wxStrspn wcsspn
482 #define wxStrstr wcsstr
483 #define wxStrtod wcstod
484 #define wxStrtol wcstol
485 #define wxStrtoul wcstoul
486 #define wxStrxfrm wcsxfrm
488 #define wxFgetc fgetwc
489 #define wxFgetchar fgetwchar
490 #define wxFgets fgetws
491 #define wxFputc fputwc
492 #define wxFputchar fputwchar
494 #define wxGetchar getwchar
496 #define wxUngetc ungetwc
499 #define wxFputs fputws
503 int wxFputs(const wxChar
*ch
, FILE *stream
);
511 int wxPutc(wxChar ch
, FILE *stream
);
515 #define wxPutchar wputchar
517 #define wxPutchar(wch) wxPutc(wch, stdout)
524 int wxPuts(const wxChar
*ws
);
527 /* we need %s to %ls conversion for printf and scanf etc */
528 #define wxNEED_PRINTF_CONVERSION
530 /* glibc doesn't have wide char equivalents of the other stuff so */
531 /* use our own versions */
532 #define wxNEED_WX_STDIO_H
533 #define wxNEED_WX_STDLIB_H
534 #define wxNEED_WX_TIME_H
535 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
536 /* ctype.h functions (wctype.h) */
537 #define wxIsalnum iswalnum
538 #define wxIsalpha iswalpha
539 #define wxIscntrl iswcntrl
540 #define wxIsdigit iswdigit
541 #define wxIsgraph iswgraph
542 #define wxIslower iswlower
543 #define wxIsprint iswprint
544 #define wxIspunct iswpunct
545 #define wxIsspace iswspace
546 #define wxIsupper iswupper
547 #define wxIsxdigit iswxdigit
548 #define wxTolower towlower
549 #define wxToupper towupper
551 /* string.h functions (wchar.h) */
552 #define wxStrcat wcscat
553 #define wxStrchr wcschr
554 #define wxStrcmp wcscmp
555 #define wxStrcoll wcscoll
556 #define wxStrcpy wcscpy
557 #define wxStrcspn wcscspn
558 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
559 #define wxStrncat wcsncat
560 #define wxStrncmp wcsncmp
561 #define wxStrncpy wcsncpy
562 #define wxStrpbrk wcspbrk
563 #define wxStrrchr wcsrchr
564 #define wxStrspn wcsspn
565 #define wxStrstr wcsstr
566 #define wxStrtod wcstod
567 #define wxStrtol wcstol
568 #define wxStrtoul wcstoul
569 #define wxStrxfrm wcsxfrm
571 #define wxFgetc fgetwc
572 #define wxFgetchar fgetwchar
573 #define wxFgets fgetws
574 #define wxFputc fputwc
575 #define wxFputchar fputwchar
577 #define wxGetchar getwchar
579 #define wxUngetc ungetwc
581 #define wxNEED_PRINTF_CONVERSION
584 #define wxPutchar putwchar
585 #define wxFputs fputws
587 /* stdio.h functions */
589 #define wxNEED_WX_STDIO_H
591 /* stdlib.h functions */
593 #define wxNEED_WX_STDLIB_H
598 #define wxGetenv(a) ((wxChar*)NULL)
599 #define wxSystem(a) ((int)NULL)
601 /* time.h functions */
602 #define wxAsctime wasciitime
603 #define wxCtime wctime
604 /* #define wxStrftime wcsftime */
606 #define wxNEED_WX_TIME_H
607 #else /* !metrowerks for apple */
608 #error "Please define wide character functions for your environment"
614 /* ctype.h functions */
615 #define wxIsalnum isalnum
616 #define wxIsalpha isalpha
617 #define wxIscntrl iscntrl
618 #define wxIsdigit isdigit
619 #define wxIsgraph isgraph
620 #define wxIslower islower
621 #define wxIsprint isprint
622 #define wxIspunct ispunct
623 #define wxIsspace isspace
624 #define wxIsupper isupper
625 #define wxIsxdigit isxdigit
626 #define wxTolower tolower
627 #define wxToupper toupper
629 /* locale.h functons */
630 #define wxSetlocale setlocale
632 /* string.h functions */
633 #define wxStrcat strcat
634 #define wxStrchr strchr
635 #define wxStrcmp strcmp
636 #define wxStrcoll strcoll
637 #define wxStrcpy strcpy
638 #define wxStrcspn strcspn
640 /* wxStricmp and wxStrnicmp are defined below */
641 #define wxStrlen_ strlen /* used in wxStrlen inline function */
642 #define wxStrncat strncat
643 #define wxStrncmp strncmp
644 #define wxStrncpy strncpy
645 #define wxStrpbrk strpbrk
646 #define wxStrrchr strrchr
647 #define wxStrspn strspn
648 #define wxStrstr strstr
649 #define wxStrtod strtod
651 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
653 #define wxStrtol strtol
654 #define wxStrtoul strtoul
655 #define wxStrxfrm strxfrm
657 /* stdio.h functions */
658 #define wxFopen fopen
659 #define wxFreopen freopen
660 #define wxRemove remove
661 #define wxRename rename
663 #define wxPerror perror
664 #define wxTmpnam tmpnam
666 #define wxFgetc fgetc
667 #define wxFgetchar fgetchar
668 #define wxFgets fgets
669 #define wxFputc fputc
670 #define wxFputs fputs
671 #define wxFputchar fputchar
672 #define wxFprintf fprintf
673 #define wxFscanf fscanf
675 #define wxGetchar getchar
677 #define wxPrintf printf
679 #define wxPutchar putchar
681 #define wxScanf scanf
682 #define wxSprintf sprintf
683 #define wxSscanf sscanf
684 #define wxUngetc ungetc
685 #define wxVfprintf vfprintf
686 #define wxVprintf vprintf
687 #define wxVsscanf vsscanf
688 #define wxVsprintf vsprintf
690 /* stdlib.h functions */
694 #define wxGetenv getenv
695 #define wxSystem system
697 /* time.h functions */
698 #define wxAsctime asctime
699 #define wxCtime ctime
700 #define wxStrftime strftime
701 #endif /* Unicode/ASCII */
702 #endif /* TCHAR-aware compilers/the others */
705 various special cases
708 /* define wxStricmp and wxStrnicmp for various compilers */
710 /* note that in Unicode mode we definitely are going to need our own version */
711 #if !defined(wxStricmp) && !wxUSE_UNICODE
712 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
713 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
714 defined(__EMX__) || defined(__DJGPP__)
715 #define wxStricmp stricmp
716 #define wxStrnicmp strnicmp
717 #elif defined(__WXPALMOS__)
718 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
719 * quick hack should do until one can be written.
721 #define wxStricmp StrCaselessCompare
722 #define wxStrnicmp strnicmp
723 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
724 (defined(__MWERKS__) && defined(__INTEL__))
725 #define wxStricmp _stricmp
726 #define wxStrnicmp _strnicmp
727 #elif defined(__UNIX__) || defined(__GNUWIN32__)
728 #define wxStricmp strcasecmp
729 #define wxStrnicmp strncasecmp
730 /* #else -- use wxWidgets implementation */
732 #endif /* !defined(wxStricmp) */
734 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
735 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
736 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
739 #define wxWcslen wcslen
741 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
743 #endif /* wxUSE_WCHAR_T */
746 /* checks whether the passed in pointer is NULL and if the string is empty */
747 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
749 /* safe version of strlen() (returns 0 if passed NULL pointer) */
750 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
754 each of strdup() and wcsdup() may or may not be available but we need both
755 of them anyhow for wx/buffer.h so we define the missing one(s) in
756 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
757 defined -- if this is somehow not the case in some situations, please
758 correct that and not the lines here
761 #define wxStrdup wxStrdupW
763 #define wxStrdup wxStrdupA
767 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
770 /* printf() family saga */
773 For some systems vsnprintf() exists in the system libraries but not in the
774 headers, so we need to declare it ourselves to be able to use it.
776 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
782 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
783 #endif /* !HAVE_VSNPRINTF_DECL */
786 First of all, we always want to define safe snprintf() function to be used
787 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
788 which we really need...), otherwise we implement it using our own printf()
791 We define function with a trailing underscore here because the real one is a
792 wrapper around it as explained below
796 #if defined(__MWERKS__)
797 #define HAVE_WCSRTOMBS 1
798 #define HAVE_VSWPRINTF 1
800 #if defined(__WATCOMC__)
801 #define wxVsnprintf_ _vsnwprintf
802 #define wxSnprintf_ _snwprintf
804 #if defined(HAVE__VSNWPRINTF)
805 #define wxVsnprintf_ _vsnwprintf
806 /* MinGW?MSVCRT has the wrong vswprintf */
807 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
808 #define wxVsnprintf_ vswprintf
811 /* all versions of CodeWarrior supported by wxWidgets apparently have */
813 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
814 /* assume we have snprintf() too if we have vsnprintf() */
815 #define wxVsnprintf_ vsnprintf
816 #define wxSnprintf_ snprintf
819 #endif /* wxVsnprintf_ not defined yet */
822 /* no [v]snprintf(), cook our own */
823 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
824 ...) ATTRIBUTE_PRINTF_3
;
827 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
832 In Unicode mode we need to have all standard functions such as wprintf() and
833 so on but not all systems have them so use our own implementations in this
836 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
837 #define wxNEED_WPRINTF
841 More Unicode complications: although both ANSI C and C++ define a number of
842 wide character functions such as wprintf(), not all environments have them.
843 Worse, those which do have different behaviours: under Windows, %s format
844 specifier changes its meaning in Unicode build and expects a Unicode string
845 while under Unix/POSIX it still means an ASCII string even for wprintf() and
846 %ls has to be used for wide strings.
848 We choose to always emulate Windows behaviour as more useful for us so even
849 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
853 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
855 we need to implement all wide character printf and scanf functions
856 either because we don't have them at all or because they don't have the
860 #include <stdio.h> /* for FILE */
862 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
863 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
864 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
865 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
866 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
867 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
868 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
869 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
870 int wxVprintf( const wxChar
*format
, va_list ap
);
871 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
872 #endif /* wxNEED_PRINTF_CONVERSION */
874 /* these 2 can be simply mapped to the versions with underscore at the end */
875 /* if we don't have to do the conversion */
877 However, if we don't have any vswprintf() at all we don't need to redefine
878 anything as our own wxVsnprintf_() already behaves as needed.
880 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
881 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
882 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
884 #define wxSnprintf wxSnprintf_
885 #define wxVsnprintf wxVsnprintf_
889 various functions which might not be available in libc and for which we
890 provide our own replacements in wxchar.cpp
893 /* ctype.h functions */
895 /* RN: Used only under OSX <= 10.2 currently */
896 #ifdef wxNEED_WX_CTYPE_H
897 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
898 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
899 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
900 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
901 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
902 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
903 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
904 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
905 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
906 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
907 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
908 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
909 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
910 #endif /* wxNEED_WX_CTYPE_H */
912 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
913 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
914 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
916 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
920 a few compilers don't have the (non standard but common) isascii function,
921 define it ourselves for them
924 #if defined(__MWERKS__)
925 #define wxNEED_ISASCII
926 #elif defined(_WIN32_WCE)
927 #if _WIN32_WCE <= 211
928 #define wxNEED_ISASCII
933 #ifdef wxNEED_ISASCII
934 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
938 #if _WIN32_WCE <= 211
939 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
941 #endif /* _WIN32_WCE */
944 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
945 initial versions of this header -- now it is too late to remove it so
946 although we fixed the function/macro name above, still provide the
947 backwards-compatible synonym.
949 #define wxIsctrl wxIscntrl
951 /* string.h functions */
953 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
954 #define wxNEED_STRDUP
955 #elif defined(__WXWINCE__)
956 #if _WIN32_WCE <= 211
957 #define wxNEED_STRDUP
963 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
966 /* RN: Used only under OSX <= 10.2 currently
967 The __cplusplus ifdefs are messy, but they are required to build
968 the regex library, since c does not support function overloading
970 #ifdef wxNEED_WX_STRING_H
974 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
975 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
976 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
977 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
978 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
979 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
980 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
981 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
982 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
983 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
984 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
985 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
986 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
991 /* These functions use C++, so we can't c extern them */
992 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
993 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
994 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
995 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
997 /* inlined versions */
999 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
1000 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
1001 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
1002 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
1003 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
1004 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
1005 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
1006 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
1009 #endif /* wxNEED_WX_STRING_H */
1012 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
1016 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
1020 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
1024 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1028 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1033 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1034 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1038 /* stdio.h functions */
1039 #ifdef wxNEED_WX_STDIO_H
1041 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1042 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1043 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1044 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1046 /* *printf() family is handled separately */
1047 #endif /* wxNEED_WX_STDIO_H */
1050 /* stdlib.h functions */
1052 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1055 #ifdef wxNEED_WX_STDLIB_H
1056 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1057 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1058 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1059 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1063 /* time.h functions */
1064 #ifdef wxNEED_WX_TIME_H
1065 #if defined(__MWERKS__) && defined(macintosh)
1068 /*silent gabby compilers*/
1070 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1071 const wxChar
*fmt
, const struct tm
*tm
);
1072 #endif /* wxNEED_WX_TIME_H */
1076 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1080 /* missing functions in some WinCE versions */
1082 #if (_WIN32_WCE < 300)
1083 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1085 #endif /* _WIN32_WCE */
1087 /* multibyte to wide char conversion functions and macros */
1090 /* multibyte<->widechar conversion */
1091 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1092 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1095 #define wxMB2WX wxMB2WC
1096 #define wxWX2MB wxWC2MB
1097 #define wxWC2WX wxStrncpy
1098 #define wxWX2WC wxStrncpy
1100 #define wxMB2WX wxStrncpy
1101 #define wxWX2MB wxStrncpy
1102 #define wxWC2WX wxWC2MB
1103 #define wxWX2WC wxMB2WC
1105 #else /* !wxUSE_UNICODE */
1106 /* Why is this here?
1108 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1109 #define wxMB2WC wxStrncpy
1110 #define wxWC2MB wxStrncpy
1111 #define wxMB2WX wxStrncpy
1112 #define wxWX2MB wxStrncpy
1113 #define wxWC2WX wxWC2MB
1114 #define wxWX2WC wxMB2WC
1118 RN: The following are not normal versions of memcpy et al., rather
1119 these are either char or widechar versions depending on
1120 if unicode is used or not.
1126 // RN: We could do the usual tricky compiler detection here,
1127 // and use their variant (such as wmemchr, etc.). The problem
1128 // is that these functions are quite rare, even though they are
1129 // part of the current POSIX standard. In addition, most compilers
1130 // (including even MSC) inline them just like we do right in their
1134 #include <string.h> //for mem funcs
1136 //implement our own wmem variants
1137 inline wxChar
* wxTmemchr(const wxChar
* s
, wxChar c
, size_t l
)
1139 for(;l
&& *s
!= c
;--l
, ++s
) {}
1146 inline int wxTmemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1148 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1151 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1156 inline wxChar
* wxTmemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1158 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1161 inline wxChar
* wxTmemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1163 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1166 inline wxChar
* wxTmemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1168 wxChar
* szRet
= szOut
;
1176 #else //!wxUSE_UNICODE
1177 # define wxTmemchr memchr
1178 # define wxTmemcmp memcmp
1179 # define wxTmemcpy memcpy
1180 # define wxTmemmove memmove
1181 # define wxTmemset memset
1184 #endif /*__cplusplus*/
1187 #endif /* _WX_WXCHAR_H_ */