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>
96 #elif defined(HAVE_WCSTR_H)
97 /* old compilers have relevant declarations here */
99 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
100 /* include stdlib.h for wchar_t */
102 #endif /* HAVE_WCHAR_H */
103 #endif /* wxUSE_WCHAR_T */
105 /* ---------------------------------------------------------------------------- */
106 /* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
107 /* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
108 /* the function mapping _tfoo() -> foo() or wfoo() */
109 /* ---------------------------------------------------------------------------- */
111 /* VC++ and BC++ starting with 5.2 have TCHAR support */
113 #define wxHAVE_TCHAR_SUPPORT
114 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
115 #define wxHAVE_TCHAR_SUPPORT
117 #elif defined(__WATCOMC__)
118 #define wxHAVE_TCHAR_SUPPORT
119 #elif defined(__DMC__)
120 #define wxHAVE_TCHAR_SUPPORT
121 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 ) && !defined(__WXPALMOS__)
122 #define wxHAVE_TCHAR_SUPPORT
126 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
127 /* VZ: the old VisualAge definitions were completely wrong and had no */
128 /* chance at all to work in Unicode build anyhow so let's pretend that */
129 /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
130 /* "0 &&" above) until someone really has time to delve into Unicode */
131 /* issues under OS/2 */
133 /* VisualAge 4.0+ supports TCHAR */
134 #define wxHAVE_TCHAR_SUPPORT
135 #endif /* compilers with (good) TCHAR support */
141 #ifdef wxHAVE_TCHAR_SUPPORT
142 /* get TCHAR definition if we've got it */
145 /* we surely do have wchar_t if we have TCHAR */
146 #ifndef wxUSE_WCHAR_T
147 #define wxUSE_WCHAR_T 1
148 #endif /* !defined(wxUSE_WCHAR_T) */
150 /* and we also do have wcslen() */
154 #endif /* wxHAVE_TCHAR_SUPPORT */
156 /* ---------------------------------------------------------------------------- */
157 /* define wxChar type */
158 /* ---------------------------------------------------------------------------- */
160 /* TODO: define wxCharInt to be equal to either int or wint_t? */
164 typedef signed char wxSChar
;
165 typedef unsigned char wxUChar
;
167 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
168 /* signed/unsigned version of it which (a) makes sense to me (unlike */
169 /* char wchar_t is always unsigned) and (b) was how the previous */
170 /* definitions worked so keep it like this */
172 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
174 #if !defined(__WCHAR_TYPE__) || \
175 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
177 typedef wchar_t wxChar
;
178 typedef wchar_t wxSChar
;
179 typedef wchar_t wxUChar
;
180 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
181 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
182 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
183 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
184 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
185 /* have to define wxChar conditionally depending on detected */
186 /* compiler & compiler version. */
187 /* with old definition of wxChar. */
188 typedef __WCHAR_TYPE__ wxChar
;
189 typedef __WCHAR_TYPE__ wxSChar
;
190 typedef __WCHAR_TYPE__ wxUChar
;
191 #endif /* __WCHAR_TYPE__ */
192 #endif /* ASCII/Unicode */
194 /* ---------------------------------------------------------------------------- */
195 /* define _T() and related macros */
196 /* ---------------------------------------------------------------------------- */
198 /* BSD systems define _T() to be something different in ctype.h, override it */
199 #if defined(__FreeBSD__) || defined(__DARWIN__)
204 /* could already be defined by tchar.h (it's quasi standard) */
210 #endif /* ASCII/Unicode */
211 #endif /* !defined(_T) */
213 /* although global macros with such names are normally bad, we want to have */
214 /* another name for _T() which should be used to avoid confusion between _T() */
215 /* and _() in wxWidgets sources */
218 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
220 #define __XFILE__(x) wxT(x)
221 #define __TFILE__ __XFILE__(__FILE__)
225 #define __XDATE__(x) wxT(x)
226 #define __TDATE__ __XDATE__(__DATE__)
230 #define __XTIME__(x) wxT(x)
231 #define __TTIME__ __XTIME__(__TIME__)
235 define wxFoo() function for each standard foo() function whose signature
236 (exceptionally including the return type) includes any mention of char:
237 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
238 the same signature but with char replaced by wxChar which allows us to use
239 it in Unicode build as well
242 #ifdef wxHAVE_TCHAR_SUPPORT
245 #if defined(__WATCOMC__) && defined(UNICODE)
246 #define WXWCHAR_T_CAST(c) (wint_t)(c)
248 #define WXWCHAR_T_CAST(c) c
251 /* ctype.h functions */
252 #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
253 #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
254 #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
255 #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
256 #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
257 #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
258 #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
259 #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
260 #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
261 #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
262 #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
265 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
266 signed chars < 0, so "fix" it here.
268 #define wxTolower(c) _totlower((wxUChar)(c))
269 #define wxToupper(c) _totupper((wxUChar)(c))
271 /* locale.h functons */
272 #define wxSetlocale _tsetlocale
274 /* string.h functions */
275 #define wxStrcat _tcscat
276 #define wxStrchr _tcschr
277 #define wxStrcmp _tcscmp
278 #define wxStrcoll _tcscoll
279 #define wxStrcpy _tcscpy
280 #define wxStrcspn _tcscspn
281 #define wxStrdupW _wcsdup /* notice the 'W'! */
282 #define wxStrftime _tcsftime
283 #define wxStricmp _tcsicmp
284 #define wxStrnicmp _tcsnicmp
285 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
286 #define wxStrncat _tcsncat
287 #define wxStrncmp _tcsncmp
288 #define wxStrncpy _tcsncpy
289 #define wxStrpbrk _tcspbrk
290 #define wxStrrchr _tcsrchr
291 #define wxStrspn _tcsspn
292 #define wxStrstr _tcsstr
293 #define wxStrtod _tcstod
294 #define wxStrtol _tcstol
295 #define wxStrtoul _tcstoul
296 #define wxStrxfrm _tcsxfrm
298 /* stdio.h functions */
299 #define wxFgetc _fgettc
300 #define wxFgetchar _fgettchar
301 #define wxFgets _fgetts
302 #if wxUSE_UNICODE_MSLU
303 #define wxFopen wxMSLU__tfopen
305 #define wxFopen _tfopen
307 #define wxFputc _fputtc
308 #define wxFputchar _fputtchar
309 #define wxFprintf _ftprintf
310 #define wxFputs _fputts
311 #define wxFreopen _tfreopen
312 #define wxFscanf _ftscanf
313 #define wxGetc _gettc
314 #define wxGetchar _gettchar
315 #define wxGets _getts
316 #define wxPerror _tperror
317 #define wxPrintf _tprintf
318 #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
319 #define wxPutchar _puttchar
320 #define wxPuts _putts
321 #define wxScanf _tscanf
324 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
325 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
327 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
328 #define wxSprintf sprintf
331 #define wxSprintf _stprintf
334 #define wxSscanf _stscanf
335 #define wxTmpnam _ttmpnam
336 #define wxUngetc _tungetc
337 #define wxVfprintf _vftprintf
338 #define wxVprintf _vtprintf
339 #define wxVsscanf _vstscanf
340 #define wxVsprintf _vstprintf
342 /* special case: not all TCHAR-aware compilers have those */
343 #if defined(__VISUALC__) || \
344 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
345 #define wxVsnprintf_ _vsntprintf
346 #define wxSnprintf_ _sntprintf
349 /* special case: these functions are missing under Win9x with Unicows so we */
350 /* have to implement them ourselves */
351 #if wxUSE_UNICODE_MSLU
352 #define wxRemove wxMSLU__tremove
353 #define wxRename wxMSLU__trename
356 #define wxRemove DeleteFile
358 #define wxRemove _tremove
359 #define wxRename _trename
363 /* stdlib.h functions */
366 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
367 #define wxGetenv _tgetenv
368 #define wxSystem _tsystem
370 /* time.h functions */
371 #define wxAsctime _tasctime
372 #define wxCtime _tctime
373 #else /* !TCHAR-aware compilers */
375 #if !defined(__MWERKS__) && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
376 /* even though they are defined and "implemented", they are bad and just
377 stubs so we need our own - we need these even in ANSI builds!! */
378 #define mbstowcs wxInternalMbstowcs
379 #define wcstombs wxInternalWcstombs
381 WXDLLIMPEXP_BASE
size_t wxInternalMbstowcs (wchar_t *, const char *, size_t);
382 WXDLLIMPEXP_BASE
size_t wxInternalWcstombs (char *, const wchar_t *, size_t);
385 /* No UNICODE in the c library except wchar_t typedef on mac OSX 10.2 and less - roll our own */
386 #if !defined(__MWERKS__) && wxUSE_UNICODE && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
388 /* we need everything! */
389 #define wxNEED_WX_STRING_H
390 #define wxNEED_WX_CTYPE_H
392 #define wxFgetchar(c) wxFgetc(c, stdin)
393 #define wxFputc wxPutc
394 #define wxFputchar(c) wxPutc(c, stdout)
395 #define wxGetc wxFgetc
396 #define wxGetchar(c) wxFgetc(c, stdin)
403 #define wxNEED_UNGETC
409 int wxFputs(const wxChar
*ch
, FILE *stream
);
410 int wxPuts(const wxChar
*ws
);
411 int wxPutc(wxChar ch
, FILE *stream
);
416 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
421 #define wxPutchar(wch) wxPutc(wch, stdout)
423 #define wxNEED_PRINTF_CONVERSION
424 #define wxNEED_WX_STDIO_H
425 #define wxNEED_WX_STDLIB_H
426 #define wxNEED_WX_TIME_H
431 /* this is probably glibc-specific */
432 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
433 /* ctype.h functions (wctype.h) */
434 #define wxIsalnum iswalnum
435 #define wxIsalpha iswalpha
436 #define wxIscntrl iswcntrl
437 #define wxIsdigit iswdigit
438 #define wxIsgraph iswgraph
439 #define wxIslower iswlower
440 #define wxIsprint iswprint
441 #define wxIspunct iswpunct
442 #define wxIsspace iswspace
443 #define wxIsupper iswupper
444 #define wxIsxdigit iswxdigit
446 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
447 /* /usr/include/wctype.h incorrectly declares translations */
448 /* tables which provokes tons of compile-time warnings -- try */
449 /* to correct this */
450 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
451 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
452 #else /* !glibc 2.0 */
453 #define wxTolower towlower
454 #define wxToupper towupper
455 #endif /* gcc/!gcc */
457 /* string.h functions (wchar.h) */
458 #define wxStrcat wcscat
459 #define wxStrchr wcschr
460 #define wxStrcmp wcscmp
461 #define wxStrcoll wcscoll
462 #define wxStrcpy wcscpy
463 #define wxStrcspn wcscspn
464 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
465 #define wxStrncat wcsncat
466 #define wxStrncmp wcsncmp
467 #define wxStrncpy wcsncpy
468 #define wxStrpbrk wcspbrk
469 #define wxStrrchr wcsrchr
470 #define wxStrspn wcsspn
471 #define wxStrstr wcsstr
472 #define wxStrtod wcstod
473 #define wxStrtol wcstol
474 #define wxStrtoul wcstoul
475 #define wxStrxfrm wcsxfrm
477 #define wxFgetc fgetwc
478 #define wxFgetchar fgetwchar
479 #define wxFgets fgetws
480 #define wxFputc fputwc
481 #define wxFputchar fputwchar
483 #define wxGetchar getwchar
485 #define wxUngetc ungetwc
488 #define wxFputs fputws
492 int wxFputs(const wxChar
*ch
, FILE *stream
);
500 int wxPutc(wxChar ch
, FILE *stream
);
504 #define wxPutchar wputchar
506 #define wxPutchar(wch) wxPutc(wch, stdout)
513 int wxPuts(const wxChar
*ws
);
516 /* we need %s to %ls conversion for printf and scanf etc */
517 #define wxNEED_PRINTF_CONVERSION
519 /* glibc doesn't have wide char equivalents of the other stuff so */
520 /* use our own versions */
521 #define wxNEED_WX_STDIO_H
522 #define wxNEED_WX_STDLIB_H
523 #define wxNEED_WX_TIME_H
524 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
525 /* ctype.h functions (wctype.h) */
526 #define wxIsalnum iswalnum
527 #define wxIsalpha iswalpha
528 #define wxIscntrl iswcntrl
529 #define wxIsdigit iswdigit
530 #define wxIsgraph iswgraph
531 #define wxIslower iswlower
532 #define wxIsprint iswprint
533 #define wxIspunct iswpunct
534 #define wxIsspace iswspace
535 #define wxIsupper iswupper
536 #define wxIsxdigit iswxdigit
537 #define wxTolower towlower
538 #define wxToupper towupper
540 /* string.h functions (wchar.h) */
541 #define wxStrcat wcscat
542 #define wxStrchr wcschr
543 #define wxStrcmp wcscmp
544 #define wxStrcoll wcscoll
545 #define wxStrcpy wcscpy
546 #define wxStrcspn wcscspn
547 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
548 #define wxStrncat wcsncat
549 #define wxStrncmp wcsncmp
550 #define wxStrncpy wcsncpy
551 #define wxStrpbrk wcspbrk
552 #define wxStrrchr wcsrchr
553 #define wxStrspn wcsspn
554 #define wxStrstr wcsstr
555 #define wxStrtod wcstod
556 #define wxStrtol wcstol
557 #define wxStrtoul wcstoul
558 #define wxStrxfrm wcsxfrm
560 #define wxFgetc fgetwc
561 #define wxFgetchar fgetwchar
562 #define wxFgets fgetws
563 #define wxFputc fputwc
564 #define wxFputchar fputwchar
566 #define wxGetchar getwchar
568 #define wxUngetc ungetwc
570 #define wxNEED_PRINTF_CONVERSION
573 #define wxPutchar putwchar
574 #define wxFputs fputws
576 /* stdio.h functions */
578 #define wxNEED_WX_STDIO_H
580 /* stdlib.h functions */
582 #define wxNEED_WX_STDLIB_H
587 #define wxGetenv(a) ((wxChar*)NULL)
588 #define wxSystem(a) ((int)NULL)
590 /* time.h functions */
591 #define wxAsctime wasciitime
592 #define wxCtime wctime
593 /* #define wxStrftime wcsftime */
595 #define wxNEED_WX_TIME_H
596 #else /* !metrowerks for apple */
597 #error "Please define wide character functions for your environment"
603 /* ctype.h functions */
604 #define wxIsalnum isalnum
605 #define wxIsalpha isalpha
606 #define wxIscntrl iscntrl
607 #define wxIsdigit isdigit
608 #define wxIsgraph isgraph
609 #define wxIslower islower
610 #define wxIsprint isprint
611 #define wxIspunct ispunct
612 #define wxIsspace isspace
613 #define wxIsupper isupper
614 #define wxIsxdigit isxdigit
615 #define wxTolower tolower
616 #define wxToupper toupper
618 /* locale.h functons */
619 #define wxSetlocale setlocale
621 /* string.h functions */
622 #define wxStrcat strcat
623 #define wxStrchr strchr
624 #define wxStrcmp strcmp
625 #define wxStrcoll strcoll
626 #define wxStrcpy strcpy
627 #define wxStrcspn strcspn
629 /* wxStricmp and wxStrnicmp are defined below */
630 #define wxStrlen_ strlen /* used in wxStrlen inline function */
631 #define wxStrncat strncat
632 #define wxStrncmp strncmp
633 #define wxStrncpy strncpy
634 #define wxStrpbrk strpbrk
635 #define wxStrrchr strrchr
636 #define wxStrspn strspn
637 #define wxStrstr strstr
638 #define wxStrtod strtod
640 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
642 #define wxStrtol strtol
643 #define wxStrtoul strtoul
644 #define wxStrxfrm strxfrm
646 /* stdio.h functions */
647 #define wxFopen fopen
648 #define wxFreopen freopen
649 #define wxRemove remove
650 #define wxRename rename
652 #define wxPerror perror
653 #define wxTmpnam tmpnam
655 #define wxFgetc fgetc
656 #define wxFgetchar fgetchar
657 #define wxFgets fgets
658 #define wxFputc fputc
659 #define wxFputs fputs
660 #define wxFputchar fputchar
661 #define wxFprintf fprintf
662 #define wxFscanf fscanf
664 #define wxGetchar getchar
666 #define wxPrintf printf
668 #define wxPutchar putchar
670 #define wxScanf scanf
671 #define wxSprintf sprintf
672 #define wxSscanf sscanf
673 #define wxUngetc ungetc
674 #define wxVfprintf vfprintf
675 #define wxVprintf vprintf
676 #define wxVsscanf vsscanf
677 #define wxVsprintf vsprintf
679 /* stdlib.h functions */
683 #define wxGetenv getenv
684 #define wxSystem system
686 /* time.h functions */
687 #define wxAsctime asctime
688 #define wxCtime ctime
689 #define wxStrftime strftime
690 #endif /* Unicode/ASCII */
691 #endif /* TCHAR-aware compilers/the others */
694 various special cases
697 /* define wxStricmp and wxStrnicmp for various compilers */
699 /* note that in Unicode mode we definitely are going to need our own version */
700 #if !defined(wxStricmp) && !wxUSE_UNICODE
701 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
702 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
703 defined(__EMX__) || defined(__DJGPP__)
704 #define wxStricmp stricmp
705 #define wxStrnicmp strnicmp
706 #elif defined(__WXPALMOS__)
707 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
708 * quick hack should do until one can be written.
710 #define wxStricmp StrCaselessCompare
711 #define wxStrnicmp strnicmp
712 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
713 (defined(__MWERKS__) && defined(__INTEL__))
714 #define wxStricmp _stricmp
715 #define wxStrnicmp _strnicmp
716 #elif defined(__UNIX__) || defined(__GNUWIN32__)
717 #define wxStricmp strcasecmp
718 #define wxStrnicmp strncasecmp
719 /* #else -- use wxWidgets implementation */
721 #endif /* !defined(wxStricmp) */
723 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
724 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
725 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
728 #define wxWcslen wcslen
730 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
732 #endif /* wxUSE_WCHAR_T */
735 /* checks whether the passed in pointer is NULL and if the string is empty */
736 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
738 /* safe version of strlen() (returns 0 if passed NULL pointer) */
739 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
743 each of strdup() and wcsdup() may or may not be available but we need both
744 of them anyhow for wx/buffer.h so we define the missing one(s) in
745 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
746 defined -- if this is somehow not the case in some situations, please
747 correct that and not the lines here
750 #define wxStrdup wxStrdupW
752 #define wxStrdup wxStrdupA
756 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
759 /* printf() family saga */
762 For some systems vsnprintf() exists in the system libraries but not in the
763 headers, so we need to declare it ourselves to be able to use it.
765 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
767 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
768 #endif /* !HAVE_VSNPRINTF_DECL */
771 First of all, we always want to define safe snprintf() function to be used
772 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
773 which we really need...), otherwise we implement it using our own printf()
776 We define function with a trailing underscore here because the real one is a
777 wrapper around it as explained below
781 #if defined(__MWERKS__)
782 #define HAVE_WCSRTOMBS 1
783 #define HAVE_VSWPRINTF 1
785 #if defined(__WATCOMC__)
786 #define wxVsnprintf_ _vsnwprintf
787 #define wxSnprintf_ _snwprintf
789 #if defined(HAVE__VSNWPRINTF)
790 #define wxVsnprintf_ _vsnwprintf
791 /* MinGW?MSVCRT has the wrong vswprintf */
792 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
793 #define wxVsnprintf_ vswprintf
796 /* all versions of CodeWarrior supported by wxWidgets apparently have */
798 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
799 /* assume we have snprintf() too if we have vsnprintf() */
800 #define wxVsnprintf_ vsnprintf
801 #define wxSnprintf_ snprintf
804 #endif /* wxVsnprintf_ not defined yet */
807 /* no [v]snprintf(), cook our own */
808 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
809 ...) ATTRIBUTE_PRINTF_3
;
812 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
817 In Unicode mode we need to have all standard functions such as wprintf() and
818 so on but not all systems have them so use our own implementations in this
821 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
822 #define wxNEED_WPRINTF
826 More Unicode complications: although both ANSI C and C++ define a number of
827 wide character functions such as wprintf(), not all environments have them.
828 Worse, those which do have different behaviours: under Windows, %s format
829 specifier changes its meaning in Unicode build and expects a Unicode string
830 while under Unix/POSIX it still means an ASCII string even for wprintf() and
831 %ls has to be used for wide strings.
833 We choose to always emulate Windows behaviour as more useful for us so even
834 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
838 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
840 we need to implement all wide character printf and scanf functions
841 either because we don't have them at all or because they don't have the
845 #include <stdio.h> /* for FILE */
847 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
848 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
849 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
850 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
851 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
852 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
853 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
854 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
855 int wxVprintf( const wxChar
*format
, va_list ap
);
856 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
857 #endif /* wxNEED_PRINTF_CONVERSION */
859 /* these 2 can be simply mapped to the versions with underscore at the end */
860 /* if we don't have to do the conversion */
862 However, if we don't have any vswprintf() at all we don't need to redefine
863 anything as our own wxVsnprintf_() already behaves as needed.
865 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
866 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
867 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
869 #define wxSnprintf wxSnprintf_
870 #define wxVsnprintf wxVsnprintf_
874 various functions which might not be available in libc and for which we
875 provide our own replacements in wxchar.cpp
878 /* ctype.h functions */
880 /* RN: Used only under OSX <= 10.2 currently */
881 #ifdef wxNEED_WX_CTYPE_H
882 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
883 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
884 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
885 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
886 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
887 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
888 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
889 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
890 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
891 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
892 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
893 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
894 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
895 #endif /* wxNEED_WX_CTYPE_H */
897 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
898 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
899 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
901 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
905 a few compilers don't have the (non standard but common) isascii function,
906 define it ourselves for them
909 #if defined(__MWERKS__)
910 #define wxNEED_ISASCII
911 #elif defined(_WIN32_WCE)
912 #if _WIN32_WCE <= 211
913 #define wxNEED_ISASCII
918 #ifdef wxNEED_ISASCII
919 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
923 #if _WIN32_WCE <= 211
924 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
926 #endif /* _WIN32_WCE */
929 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
930 initial versions of this header -- now it is too late to remove it so
931 although we fixed the function/macro name above, still provide the
932 backwards-compatible synonym.
934 #define wxIsctrl wxIscntrl
936 /* string.h functions */
938 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
939 #define wxNEED_STRDUP
940 #elif defined(__WXWINCE__)
941 #if _WIN32_WCE <= 211
942 #define wxNEED_STRDUP
948 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
951 /* RN: Used only under OSX <= 10.2 currently
952 The __cplusplus ifdefs are messy, but they are required to build
953 the regex library, since c does not support function overloading
955 #ifdef wxNEED_WX_STRING_H
959 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
960 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
961 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
962 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
963 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
964 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
965 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
966 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
967 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
968 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
969 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
970 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
971 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
976 /* These functions use C++, so we can't c extern them */
977 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
978 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
979 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
980 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
982 /* inlined versions */
984 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
985 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
986 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
987 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
988 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
989 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
990 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
991 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
994 #endif /* wxNEED_WX_STRING_H */
997 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
1001 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
1005 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
1009 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1013 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1018 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1019 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1023 /* stdio.h functions */
1024 #ifdef wxNEED_WX_STDIO_H
1026 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1027 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1028 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1029 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1031 /* *printf() family is handled separately */
1032 #endif /* wxNEED_WX_STDIO_H */
1035 /* stdlib.h functions */
1037 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1040 #ifdef wxNEED_WX_STDLIB_H
1041 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1042 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1043 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1044 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1048 /* time.h functions */
1049 #ifdef wxNEED_WX_TIME_H
1050 #if defined(__MWERKS__) && defined(macintosh)
1053 /*silent gabby compilers*/
1055 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1056 const wxChar
*fmt
, const struct tm
*tm
);
1057 #endif /* wxNEED_WX_TIME_H */
1061 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1065 /* missing functions in some WinCE versions */
1067 #if (_WIN32_WCE < 300)
1068 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1070 #endif /* _WIN32_WCE */
1072 /* multibyte to wide char conversion functions and macros */
1075 /* multibyte<->widechar conversion */
1076 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1077 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1080 #define wxMB2WX wxMB2WC
1081 #define wxWX2MB wxWC2MB
1082 #define wxWC2WX wxStrncpy
1083 #define wxWX2WC wxStrncpy
1085 #define wxMB2WX wxStrncpy
1086 #define wxWX2MB wxStrncpy
1087 #define wxWC2WX wxWC2MB
1088 #define wxWX2WC wxMB2WC
1090 #else /* !wxUSE_UNICODE */
1091 /* Why is this here?
1093 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1094 #define wxMB2WC wxStrncpy
1095 #define wxWC2MB wxStrncpy
1096 #define wxMB2WX wxStrncpy
1097 #define wxWX2MB wxStrncpy
1098 #define wxWC2WX wxWC2MB
1099 #define wxWX2WC wxMB2WC
1103 // RN: The following are not normal versions of memcpy et al., rather
1104 // these are either char or widechar versions depending on
1105 // if unicode is used or not.
1111 // RN: We could do the usual tricky compiler detection here,
1112 // and use their variant (such as wmemchr, etc.). The problem
1113 // is that these functions are quite rare, even though they are
1114 // part of the current POSIX standard. In addition, most compilers
1115 // (including even MSC) inline them just like we do right in their
1119 #include <string.h> //for mem funcs
1121 //implement our own wmem variants
1122 inline wxChar
* wxTmemchr(const wxChar
* s
, wxChar c
, size_t l
)
1124 for(;l
&& *s
!= c
;--l
, ++s
) {}
1131 inline int wxTmemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1133 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1136 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1141 inline wxChar
* wxTmemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1143 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1146 inline wxChar
* wxTmemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1148 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1151 inline wxChar
* wxTmemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1153 wxChar
* szRet
= szOut
;
1161 #else //!wxUSE_UNICODE
1162 # define wxTmemchr memchr
1163 # define wxTmemcmp memcmp
1164 # define wxTmemcpy memcpy
1165 # define wxTmemmove memmove
1166 # define wxTmemset memset
1169 #endif /*__cplusplus*/
1172 #endif /* _WX_WXCHAR_H_ */