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(__PALMOS__)
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 /* ctype.h functions */
246 #define wxIsalnum _istalnum
247 #define wxIsalpha _istalpha
248 #define wxIscntrl _istcntrl
249 #define wxIsdigit _istdigit
250 #define wxIsgraph _istgraph
251 #define wxIslower _istlower
252 #define wxIsprint _istprint
253 #define wxIspunct _istpunct
254 #define wxIsspace _istspace
255 #define wxIsupper _istupper
256 #define wxIsxdigit _istxdigit
259 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
260 signed chars < 0, so "fix" it here.
262 #define wxTolower(c) _totlower((wxUChar)(c))
263 #define wxToupper(c) _totupper((wxUChar)(c))
265 /* locale.h functons */
266 #define wxSetlocale _tsetlocale
268 /* string.h functions */
269 #define wxStrcat _tcscat
270 #define wxStrchr _tcschr
271 #define wxStrcmp _tcscmp
272 #define wxStrcoll _tcscoll
273 #define wxStrcpy _tcscpy
274 #define wxStrcspn _tcscspn
275 #define wxStrdupW _wcsdup /* notice the 'W'! */
276 #define wxStrftime _tcsftime
277 #define wxStricmp _tcsicmp
278 #define wxStrnicmp _tcsnicmp
279 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
280 #define wxStrncat _tcsncat
281 #define wxStrncmp _tcsncmp
282 #define wxStrncpy _tcsncpy
283 #define wxStrpbrk _tcspbrk
284 #define wxStrrchr _tcsrchr
285 #define wxStrspn _tcsspn
286 #define wxStrstr _tcsstr
287 #define wxStrtod _tcstod
288 #define wxStrtol _tcstol
289 #define wxStrtoul _tcstoul
290 #define wxStrxfrm _tcsxfrm
292 /* stdio.h functions */
293 #define wxFgetc _fgettc
294 #define wxFgetchar _fgettchar
295 #define wxFgets _fgetts
296 #define wxFopen _tfopen
297 #define wxFputc _fputtc
298 #define wxFputchar _fputtchar
299 #define wxFprintf _ftprintf
300 #define wxFputs _fputts
301 #define wxFreopen _tfreopen
302 #define wxFscanf _ftscanf
303 #define wxGetc _gettc
304 #define wxGetchar _gettchar
305 #define wxGets _getts
306 #define wxPerror _tperror
307 #define wxPrintf _tprintf
308 #define wxPutc _puttc
309 #define wxPutchar _puttchar
310 #define wxPuts _putts
311 #define wxScanf _tscanf
314 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
315 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
317 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
318 #define wxSprintf sprintf
321 #define wxSprintf _stprintf
324 #define wxSscanf _stscanf
325 #define wxTmpnam _ttmpnam
326 #define wxUngetc _tungetc
327 #define wxVfprintf _vftprintf
328 #define wxVprintf _vtprintf
329 #define wxVsscanf _vstscanf
330 #define wxVsprintf _vstprintf
332 /* special case: not all TCHAR-aware compilers have those */
333 #if defined(__VISUALC__) || \
334 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
335 #define wxVsnprintf_ _vsntprintf
336 #define wxSnprintf_ _sntprintf
339 /* special case: these functions are missing under Win9x with Unicows so we */
340 /* have to implement them ourselves */
341 #if wxUSE_UNICODE_MSLU
342 #define wxRemove wxMSLU__tremove
343 #define wxRename wxMSLU__trename
346 #define wxRemove DeleteFile
348 #define wxRemove _tremove
349 #define wxRename _trename
353 /* stdlib.h functions */
356 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
357 #define wxGetenv _tgetenv
358 #define wxSystem _tsystem
360 /* time.h functions */
361 #define wxAsctime _tasctime
362 #define wxCtime _tctime
363 #else /* !TCHAR-aware compilers */
365 #if !defined(__MWERKS__) && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
366 /* even though they are defined and "implemented", they are bad and just
367 stubs so we need our own - we need these even in ANSI builds!! */
368 #define mbstowcs wxInternalMbstowcs
369 #define wcstombs wxInternalWcstombs
371 WXDLLIMPEXP_BASE
size_t wxInternalMbstowcs (wchar_t *, const char *, size_t);
372 WXDLLIMPEXP_BASE
size_t wxInternalWcstombs (char *, const wchar_t *, size_t);
375 /* No UNICODE in the c library except wchar_t typedef on mac OSX 10.2 and less - roll our own */
376 #if !defined(__MWERKS__) && wxUSE_UNICODE && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
378 /* we need everything! */
379 #define wxNEED_WX_STRING_H
380 #define wxNEED_WX_CTYPE_H
382 #define wxFgetchar(c) wxFgetc(c, stdin)
383 #define wxFputc wxPutc
384 #define wxFputchar(c) wxPutc(c, stdout)
385 #define wxGetc wxFgetc
386 #define wxGetchar(c) wxFgetc(c, stdin)
393 #define wxNEED_UNGETC
399 int wxFputs(const wxChar
*ch
, FILE *stream
);
400 int wxPuts(const wxChar
*ws
);
401 int wxPutc(wxChar ch
, FILE *stream
);
406 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
411 #define wxPutchar(wch) wxPutc(wch, stdout)
413 #define wxNEED_PRINTF_CONVERSION
414 #define wxNEED_WX_STDIO_H
415 #define wxNEED_WX_STDLIB_H
416 #define wxNEED_WX_TIME_H
421 /* this is probably glibc-specific */
422 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
423 /* ctype.h functions (wctype.h) */
424 #define wxIsalnum iswalnum
425 #define wxIsalpha iswalpha
426 #define wxIscntrl iswcntrl
427 #define wxIsdigit iswdigit
428 #define wxIsgraph iswgraph
429 #define wxIslower iswlower
430 #define wxIsprint iswprint
431 #define wxIspunct iswpunct
432 #define wxIsspace iswspace
433 #define wxIsupper iswupper
434 #define wxIsxdigit iswxdigit
436 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
437 /* /usr/include/wctype.h incorrectly declares translations */
438 /* tables which provokes tons of compile-time warnings -- try */
439 /* to correct this */
440 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
441 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
442 #else /* !glibc 2.0 */
443 #define wxTolower towlower
444 #define wxToupper towupper
445 #endif /* gcc/!gcc */
447 /* string.h functions (wchar.h) */
448 #define wxStrcat wcscat
449 #define wxStrchr wcschr
450 #define wxStrcmp wcscmp
451 #define wxStrcoll wcscoll
452 #define wxStrcpy wcscpy
453 #define wxStrcspn wcscspn
454 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
455 #define wxStrncat wcsncat
456 #define wxStrncmp wcsncmp
457 #define wxStrncpy wcsncpy
458 #define wxStrpbrk wcspbrk
459 #define wxStrrchr wcsrchr
460 #define wxStrspn wcsspn
461 #define wxStrstr wcsstr
462 #define wxStrtod wcstod
463 #define wxStrtol wcstol
464 #define wxStrtoul wcstoul
465 #define wxStrxfrm wcsxfrm
467 #define wxFgetc fgetwc
468 #define wxFgetchar fgetwchar
469 #define wxFgets fgetws
470 #define wxFputc fputwc
471 #define wxFputchar fputwchar
473 #define wxGetchar getwchar
475 #define wxUngetc ungetwc
478 #define wxFputs fputws
482 int wxFputs(const wxChar
*ch
, FILE *stream
);
490 int wxPutc(wxChar ch
, FILE *stream
);
494 #define wxPutchar wputchar
496 #define wxPutchar(wch) wxPutc(wch, stdout)
503 int wxPuts(const wxChar
*ws
);
506 /* we need %s to %ls conversion for printf and scanf etc */
507 #define wxNEED_PRINTF_CONVERSION
509 /* glibc doesn't have wide char equivalents of the other stuff so */
510 /* use our own versions */
511 #define wxNEED_WX_STDIO_H
512 #define wxNEED_WX_STDLIB_H
513 #define wxNEED_WX_TIME_H
514 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
515 /* ctype.h functions (wctype.h) */
516 #define wxIsalnum iswalnum
517 #define wxIsalpha iswalpha
518 #define wxIscntrl iswcntrl
519 #define wxIsdigit iswdigit
520 #define wxIsgraph iswgraph
521 #define wxIslower iswlower
522 #define wxIsprint iswprint
523 #define wxIspunct iswpunct
524 #define wxIsspace iswspace
525 #define wxIsupper iswupper
526 #define wxIsxdigit iswxdigit
527 #define wxTolower towlower
528 #define wxToupper towupper
530 /* string.h functions (wchar.h) */
531 #define wxStrcat wcscat
532 #define wxStrchr wcschr
533 #define wxStrcmp wcscmp
534 #define wxStrcoll wcscoll
535 #define wxStrcpy wcscpy
536 #define wxStrcspn wcscspn
537 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
538 #define wxStrncat wcsncat
539 #define wxStrncmp wcsncmp
540 #define wxStrncpy wcsncpy
541 #define wxStrpbrk wcspbrk
542 #define wxStrrchr wcsrchr
543 #define wxStrspn wcsspn
544 #define wxStrstr wcsstr
545 #define wxStrtod wcstod
546 #define wxStrtol wcstol
547 #define wxStrtoul wcstoul
548 #define wxStrxfrm wcsxfrm
550 #define wxFgetc fgetwc
551 #define wxFgetchar fgetwchar
552 #define wxFgets fgetws
553 #define wxFputc fputwc
554 #define wxFputchar fputwchar
556 #define wxGetchar getwchar
558 #define wxUngetc ungetwc
560 #define wxNEED_PRINTF_CONVERSION
563 #define wxPutchar putwchar
564 #define wxFputs fputws
566 /* stdio.h functions */
568 #define wxNEED_WX_STDIO_H
570 /* stdlib.h functions */
572 #define wxNEED_WX_STDLIB_H
577 #define wxGetenv(a) ((wxChar*)NULL)
578 #define wxSystem(a) ((int)NULL)
580 /* time.h functions */
581 #define wxAsctime wasciitime
582 #define wxCtime wctime
583 /* #define wxStrftime wcsftime */
585 #define wxNEED_WX_TIME_H
586 #else /* !metrowerks for apple */
587 #error "Please define wide character functions for your environment"
593 /* ctype.h functions */
594 #define wxIsalnum isalnum
595 #define wxIsalpha isalpha
596 #define wxIscntrl iscntrl
597 #define wxIsdigit isdigit
598 #define wxIsgraph isgraph
599 #define wxIslower islower
600 #define wxIsprint isprint
601 #define wxIspunct ispunct
602 #define wxIsspace isspace
603 #define wxIsupper isupper
604 #define wxIsxdigit isxdigit
605 #define wxTolower tolower
606 #define wxToupper toupper
608 /* locale.h functons */
609 #define wxSetlocale setlocale
611 /* string.h functions */
612 #define wxStrcat strcat
613 #define wxStrchr strchr
614 #define wxStrcmp strcmp
615 #define wxStrcoll strcoll
616 #define wxStrcpy strcpy
617 #define wxStrcspn strcspn
619 /* wxStricmp and wxStrnicmp are defined below */
620 #define wxStrlen_ strlen /* used in wxStrlen inline function */
621 #define wxStrncat strncat
622 #define wxStrncmp strncmp
623 #define wxStrncpy strncpy
624 #define wxStrpbrk strpbrk
625 #define wxStrrchr strrchr
626 #define wxStrspn strspn
627 #define wxStrstr strstr
628 #define wxStrtod strtod
630 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
632 #define wxStrtol strtol
633 #define wxStrtoul strtoul
634 #define wxStrxfrm strxfrm
636 /* stdio.h functions */
637 #define wxFopen fopen
638 #define wxFreopen freopen
639 #define wxRemove remove
640 #define wxRename rename
642 #define wxPerror perror
643 #define wxTmpnam tmpnam
645 #define wxFgetc fgetc
646 #define wxFgetchar fgetchar
647 #define wxFgets fgets
648 #define wxFputc fputc
649 #define wxFputs fputs
650 #define wxFputchar fputchar
651 #define wxFprintf fprintf
652 #define wxFscanf fscanf
654 #define wxGetchar getchar
656 #define wxPrintf printf
658 #define wxPutchar putchar
660 #define wxScanf scanf
661 #define wxSprintf sprintf
662 #define wxSscanf sscanf
663 #define wxUngetc ungetc
664 #define wxVfprintf vfprintf
665 #define wxVprintf vprintf
666 #define wxVsscanf vsscanf
667 #define wxVsprintf vsprintf
669 /* stdlib.h functions */
673 #define wxGetenv getenv
674 #define wxSystem system
676 /* time.h functions */
677 #define wxAsctime asctime
678 #define wxCtime ctime
679 #define wxStrftime strftime
680 #endif /* Unicode/ASCII */
681 #endif /* TCHAR-aware compilers/the others */
684 various special cases
687 /* define wxStricmp and wxStrnicmp for various compilers */
689 /* note that in Unicode mode we definitely are going to need our own version */
690 #if !defined(wxStricmp) && !wxUSE_UNICODE
691 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
692 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
693 defined(__EMX__) || defined(__DJGPP__)
694 #define wxStricmp stricmp
695 #define wxStrnicmp strnicmp
696 #elif defined(__PALMOS__)
697 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
698 * quick hack should do until one can be written.
700 #define wxStricmp StrCaselessCompare
701 #define wxStrnicmp strnicmp
702 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
703 (defined(__MWERKS__) && defined(__INTEL__))
704 #define wxStricmp _stricmp
705 #define wxStrnicmp _strnicmp
706 #elif defined(__UNIX__) || defined(__GNUWIN32__)
707 #define wxStricmp strcasecmp
708 #define wxStrnicmp strncasecmp
709 /* #else -- use wxWidgets implementation */
711 #endif /* !defined(wxStricmp) */
713 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
714 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
715 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
718 #define wxWcslen wcslen
720 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
722 #endif /* wxUSE_WCHAR_T */
725 /* checks whether the passed in pointer is NULL and if the string is empty */
726 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
728 /* safe version of strlen() (returns 0 if passed NULL pointer) */
729 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
733 each of strdup() and wcsdup() may or may not be available but we need both
734 of them anyhow for wx/buffer.h so we define the missing one(s) in
735 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
736 defined -- if this is somehow not the case in some situations, please
737 correct that and not the lines here
740 #define wxStrdup wxStrdupW
742 #define wxStrdup wxStrdupA
746 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
749 /* printf() family saga */
752 For some systems vsnprintf() exists in the system libraries but not in the
753 headers, so we need to declare it ourselves to be able to use it.
755 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
757 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
758 #endif /* !HAVE_VSNPRINTF_DECL */
761 First of all, we always want to define safe snprintf() function to be used
762 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
763 which we really need...), otherwise we implement it using our own printf()
766 We define function with a trailing underscore here because the real one is a
767 wrapper around it as explained below
771 #if defined(__MWERKS__)
772 #define HAVE_WCSRTOMBS 1
773 #define HAVE_VSWPRINTF 1
775 #if defined(__WATCOMC__)
776 #define wxVsnprintf_ _vsnwprintf
777 #define wxSnprintf_ _snwprintf
779 #if defined(HAVE__VSNWPRINTF)
780 #define wxVsnprintf_ _vsnwprintf
781 /* MinGW?MSVCRT has the wrong vswprintf */
782 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
783 #define wxVsnprintf_ vswprintf
786 /* all versions of CodeWarrior supported by wxWidgets apparently have */
788 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
789 /* assume we have snprintf() too if we have vsnprintf() */
790 #define wxVsnprintf_ vsnprintf
791 #define wxSnprintf_ snprintf
794 #endif /* wxVsnprintf_ not defined yet */
797 /* no [v]snprintf(), cook our own */
798 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
799 ...) ATTRIBUTE_PRINTF_3
;
802 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
807 In Unicode mode we need to have all standard functions such as wprintf() and
808 so on but not all systems have them so use our own implementations in this
811 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
812 #define wxNEED_WPRINTF
816 More Unicode complications: although both ANSI C and C++ define a number of
817 wide character functions such as wprintf(), not all environments have them.
818 Worse, those which do have different behaviours: under Windows, %s format
819 specifier changes its meaning in Unicode build and expects a Unicode string
820 while under Unix/POSIX it still means an ASCII string even for wprintf() and
821 %ls has to be used for wide strings.
823 We choose to always emulate Windows behaviour as more useful for us so even
824 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
828 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
830 we need to implement all wide character printf and scanf functions
831 either because we don't have them at all or because they don't have the
835 #include <stdio.h> /* for FILE */
837 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
838 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
839 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
840 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
841 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
842 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
843 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
844 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
845 int wxVprintf( const wxChar
*format
, va_list ap
);
846 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
847 #endif /* wxNEED_PRINTF_CONVERSION */
849 /* these 2 can be simply mapped to the versions with underscore at the end */
850 /* if we don't have to do the conversion */
852 However, if we don't have any vswprintf() at all we don't need to redefine
853 anything as our own wxVsnprintf_() already behaves as needed.
855 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
856 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
857 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
859 #define wxSnprintf wxSnprintf_
860 #define wxVsnprintf wxVsnprintf_
864 various functions which might not be available in libc and for which we
865 provide our own replacements in wxchar.cpp
868 /* ctype.h functions */
870 /* RN: Used only under OSX <= 10.2 currently */
871 #ifdef wxNEED_WX_CTYPE_H
872 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
873 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
874 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
875 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
876 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
877 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
878 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
879 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
880 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
881 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
882 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
883 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
884 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
885 #endif /* wxNEED_WX_CTYPE_H */
887 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
888 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
889 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
891 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
895 a few compilers don't have the (non standard but common) isascii function,
896 define it ourselves for them
899 #if defined(__MWERKS__)
900 #define wxNEED_ISASCII
901 #elif defined(_WIN32_WCE)
902 #if _WIN32_WCE <= 211
903 #define wxNEED_ISASCII
908 #ifdef wxNEED_ISASCII
909 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
913 #if _WIN32_WCE <= 211
914 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
916 #endif /* _WIN32_WCE */
919 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
920 initial versions of this header -- now it is too late to remove it so
921 although we fixed the function/macro name above, still provide the
922 backwards-compatible synonym.
924 #define wxIsctrl wxIscntrl
926 /* string.h functions */
928 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
929 #define wxNEED_STRDUP
930 #elif defined(__WXWINCE__)
931 #if _WIN32_WCE <= 211
932 #define wxNEED_STRDUP
938 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
941 /* RN: Used only under OSX <= 10.2 currently
942 The __cplusplus ifdefs are messy, but they are required to build
943 the regex library, since c does not support function overloading
945 #ifdef wxNEED_WX_STRING_H
949 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
950 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
951 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
952 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
953 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
954 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
955 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
956 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
957 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
958 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
959 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
960 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
961 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
966 /* These functions use C++, so we can't c extern them */
967 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
968 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
969 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
970 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
972 /* inlined versions */
974 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
975 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
976 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
977 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
978 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
979 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
980 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
981 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
984 #endif /* wxNEED_WX_STRING_H */
987 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
991 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
995 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
999 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1003 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1008 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1009 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1013 /* stdio.h functions */
1014 #ifdef wxNEED_WX_STDIO_H
1016 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1017 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1018 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1019 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1021 /* *printf() family is handled separately */
1022 #endif /* wxNEED_WX_STDIO_H */
1025 /* stdlib.h functions */
1027 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1030 #ifdef wxNEED_WX_STDLIB_H
1031 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1032 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1033 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1034 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1038 /* time.h functions */
1039 #ifdef wxNEED_WX_TIME_H
1040 #if defined(__MWERKS__) && defined(macintosh)
1043 /*silent gabby compilers*/
1045 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1046 const wxChar
*fmt
, const struct tm
*tm
);
1047 #endif /* wxNEED_WX_TIME_H */
1051 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1055 /* missing functions in some WinCE versions */
1057 #if (_WIN32_WCE < 300)
1058 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1060 #endif /* _WIN32_WCE */
1062 /* multibyte to wide char conversion functions and macros */
1065 /* multibyte<->widechar conversion */
1066 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1067 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1070 #define wxMB2WX wxMB2WC
1071 #define wxWX2MB wxWC2MB
1072 #define wxWC2WX wxStrncpy
1073 #define wxWX2WC wxStrncpy
1075 #define wxMB2WX wxStrncpy
1076 #define wxWX2MB wxStrncpy
1077 #define wxWC2WX wxWC2MB
1078 #define wxWX2WC wxMB2WC
1080 #else /* !wxUSE_UNICODE */
1081 /* Why is this here?
1083 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1084 #define wxMB2WC wxStrncpy
1085 #define wxWC2MB wxStrncpy
1086 #define wxMB2WX wxStrncpy
1087 #define wxWX2MB wxStrncpy
1088 #define wxWC2WX wxWC2MB
1089 #define wxWX2WC wxMB2WC
1093 // RN: The following are not normal versions of memcpy et al., rather
1094 // these are either char or widechar versions depending on
1095 // if unicode is used or not.
1101 // RN: We could do the usual tricky compiler detection here,
1102 // and use their variant (such as wmemchr, etc.). The problem
1103 // is that these functions are quite rare, even though they are
1104 // part of the current POSIX standard. In addition, most compilers
1105 // (including even MSC) inline them just like we do right in their
1109 #include <string.h> //for mem funcs
1111 //implement our own wmem variants
1112 inline wxChar
* wxMemchr(const wxChar
* s
, wxChar c
, size_t l
)
1114 for(;l
&& *s
!= c
;--l
, ++s
) {}
1121 inline int wxMemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1123 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1126 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1131 inline wxChar
* wxMemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1133 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1136 inline wxChar
* wxMemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1138 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1141 inline wxChar
* wxMemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1143 wxChar
* szRet
= szOut
;
1151 #else //!wxUSE_UNICODE
1152 # define wxMemchr memchr
1153 # define wxMemcmp memcmp
1154 # define wxMemcpy memcpy
1155 # define wxMemmove memmove
1156 # define wxMemset memset
1159 #endif /*__cplusplus*/
1162 #endif /* _WX_WXCHAR_H_ */