3 * Purpose: Declarations common to wx char/wchar_t usage (wide chars)
4 * Author: Joel Farley, Ove Kåven
5 * Modified by: Vadim Zeitlin, Robert Roebling, Ron Lee
8 * Copyright: (c) 1998-2002 Joel Farley, Ove Kåven, Robert Roebling, Ron Lee
9 * Licence: wxWindows licence
12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
17 /* defs.h indirectly includes this file, so don't include it here */
18 #include "wx/platform.h"
19 #include "wx/dlimpexp.h"
21 #if defined(HAVE_STRTOK_R) && defined(__DARWIN__) && defined(_MSL_USING_MW_C_HEADERS) && _MSL_USING_MW_C_HEADERS
22 char *strtok_r(char *, const char *, char **);
25 /* check whether we have wchar_t and which size it is if we do */
26 #if !defined(wxUSE_WCHAR_T)
28 #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || defined(__DARWIN__)
29 #define wxUSE_WCHAR_T 1
31 #define wxUSE_WCHAR_T 0
33 #elif defined(__GNUWIN32__) && !defined(__MINGW32__)
34 #define wxUSE_WCHAR_T 0
35 #elif defined(__WATCOMC__)
36 #define wxUSE_WCHAR_T 0
37 #elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
38 #define wxUSE_WCHAR_T 0
40 /* add additional compiler checks if this fails */
41 #define wxUSE_WCHAR_T 1
43 #endif /* !defined(wxUSE_WCHAR_T) */
45 /* Unicode support requires wchar_t */
46 #if wxUSE_UNICODE && !wxUSE_WCHAR_T
47 #error "wchar_t must be available in Unicode build"
51 Standard headers we need here.
53 NB: don't include any wxWidgets headers here because almost all of them include
57 /* Required for wxPrintf() etc */
60 /* Almost all compiler have strdup(), but not quite all: CodeWarrior under Mac */
61 /* and VC++ for Windows CE don't provide it */
62 #if defined(__VISUALC__) && __VISUALC__ >= 1400
63 #define wxStrdupA _strdup
64 #elif !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
65 /* use #define, not inline wrapper, as it is tested with #ifndef below */
66 #define wxStrdupA strdup
70 non Unix compilers which do have wchar.h (but not tchar.h which is included
71 below and which includes wchar.h anyhow).
73 Actually MinGW has tchar.h, but it does not include wchar.h
75 #if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__) || defined(__WATCOMC__)
80 #if defined(__MWERKS__) && !defined(__MACH__)
88 /* the current (as of Nov 2002) version of cygwin has a bug in its */
89 /* wchar.h -- there is no extern "C" around the declarations in it and */
90 /* this results in linking errors later; also, at least on some */
91 /* Cygwin versions, wchar.h requires sys/types.h */
93 #include <sys/types.h>
101 #if defined(__CYGWIN__) && defined(__cplusplus)
103 #endif /* Cygwin and C++ */
105 #elif defined(HAVE_WCSTR_H)
106 /* old compilers have relevant declarations here */
108 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
109 /* include stdlib.h for wchar_t */
111 #endif /* HAVE_WCHAR_H */
112 #endif /* wxUSE_WCHAR_T */
114 /* ---------------------------------------------------------------------------- */
115 /* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
116 /* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
117 /* the function mapping _tfoo() -> foo() or wfoo() */
118 /* ---------------------------------------------------------------------------- */
120 /* VC++ and BC++ starting with 5.2 have TCHAR support */
122 #define wxHAVE_TCHAR_SUPPORT
123 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
124 #define wxHAVE_TCHAR_SUPPORT
126 #elif defined(__WATCOMC__)
127 #define wxHAVE_TCHAR_SUPPORT
128 #elif defined(__DMC__)
129 #define wxHAVE_TCHAR_SUPPORT
130 #elif defined(__WXPALMOS__)
132 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 )
133 #define wxHAVE_TCHAR_SUPPORT
137 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
138 /* VZ: the old VisualAge definitions were completely wrong and had no */
139 /* chance at all to work in Unicode build anyhow so let's pretend that */
140 /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
141 /* "0 &&" above) until someone really has time to delve into Unicode */
142 /* issues under OS/2 */
144 /* VisualAge 4.0+ supports TCHAR */
145 #define wxHAVE_TCHAR_SUPPORT
146 #endif /* compilers with (good) TCHAR support */
148 #if defined(__MWERKS__)
149 /* Metrowerks only has wide char support for OS X >= 10.3 */
150 #if !defined(__DARWIN__) || \
151 (MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_3)
152 #define wxHAVE_MWERKS_UNICODE
155 #ifdef wxHAVE_MWERKS_UNICODE
158 #endif /* __MWERKS__ */
160 #ifdef wxHAVE_TCHAR_SUPPORT
161 /* get TCHAR definition if we've got it */
164 /* we surely do have wchar_t if we have TCHAR */
165 #ifndef wxUSE_WCHAR_T
166 #define wxUSE_WCHAR_T 1
167 #endif /* !defined(wxUSE_WCHAR_T) */
169 /* and we also do have wcslen() */
173 #endif /* wxHAVE_TCHAR_SUPPORT */
175 /* ---------------------------------------------------------------------------- */
176 /* define wxChar type */
177 /* ---------------------------------------------------------------------------- */
179 /* TODO: define wxCharInt to be equal to either int or wint_t? */
183 typedef signed char wxSChar
;
184 typedef unsigned char wxUChar
;
186 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
187 /* signed/unsigned version of it which (a) makes sense to me (unlike */
188 /* char wchar_t is always unsigned) and (b) was how the previous */
189 /* definitions worked so keep it like this */
191 /* Sun's SunPro compiler supports the wchar_t type and wide character */
192 /* functions, but does not define __WCHAR_TYPE__. Define it here to */
193 /* allow unicode enabled builds. */
194 #if defined(__SUNPRO_CC) || defined(__SUNPRO_C)
195 #define __WCHAR_TYPE__ wxchar_t
198 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
200 #if !defined(__WCHAR_TYPE__) || \
201 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
203 typedef wchar_t wxChar
;
204 typedef wchar_t wxSChar
;
205 typedef wchar_t wxUChar
;
206 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
207 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
208 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
209 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
210 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
211 /* have to define wxChar conditionally depending on detected */
212 /* compiler & compiler version. */
213 /* with old definition of wxChar. */
214 typedef __WCHAR_TYPE__ wxChar
;
215 typedef __WCHAR_TYPE__ wxSChar
;
216 typedef __WCHAR_TYPE__ wxUChar
;
217 #endif /* __WCHAR_TYPE__ */
218 #endif /* ASCII/Unicode */
220 /* ---------------------------------------------------------------------------- */
221 /* define _T() and related macros */
222 /* ---------------------------------------------------------------------------- */
224 /* BSD systems define _T() to be something different in ctype.h, override it */
225 #if defined(__FreeBSD__) || defined(__DARWIN__)
230 /* could already be defined by tchar.h (it's quasi standard) */
235 /* use wxCONCAT_HELPER so that x could be expanded if it's a macro */
236 #define _T(x) wxCONCAT_HELPER(L, x)
237 #endif /* ASCII/Unicode */
238 #endif /* !defined(_T) */
240 /* although global macros with such names are normally bad, we want to have */
241 /* another name for _T() which should be used to avoid confusion between _T() */
242 /* and _() in wxWidgets sources */
245 /* a helper macro allowing to make another macro Unicode-friendly, see below */
246 #define wxAPPLY_T(x) _T(x)
248 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
250 #define __TFILE__ wxAPPLY_T(__FILE__)
254 #define __TDATE__ wxAPPLY_T(__DATE__)
258 #define __TTIME__ wxAPPLY_T(__TIME__)
262 define wxFoo() function for each standard foo() function whose signature
263 (exceptionally including the return type) includes any mention of char:
264 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
265 the same signature but with char replaced by wxChar which allows us to use
266 it in Unicode build as well
269 #ifdef wxHAVE_TCHAR_SUPPORT
272 #if defined(__WATCOMC__) && defined(UNICODE)
273 #define WXWCHAR_T_CAST(c) (wint_t)(c)
275 #define WXWCHAR_T_CAST(c) c
278 /* ctype.h functions */
279 #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
280 #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
281 #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
282 #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
283 #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
284 #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
285 #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
286 #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
287 #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
288 #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
289 #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
292 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
293 signed chars < 0, so "fix" it here.
295 #define wxTolower(c) _totlower((wxUChar)(c))
296 #define wxToupper(c) _totupper((wxUChar)(c))
298 /* locale.h functons */
299 #define wxSetlocale _tsetlocale
301 /* string.h functions */
302 #define wxStrcat _tcscat
303 #define wxStrchr _tcschr
304 #define wxStrcmp _tcscmp
305 #define wxStrcoll _tcscoll
306 #define wxStrcpy _tcscpy
307 #define wxStrcspn _tcscspn
308 #define wxStrdupW _wcsdup /* notice the 'W'! */
309 #define wxStrftime _tcsftime
310 #define wxStricmp _tcsicmp
311 #define wxStrnicmp _tcsnicmp
312 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
313 #define wxStrncat _tcsncat
314 #define wxStrncmp _tcsncmp
315 #define wxStrncpy _tcsncpy
316 #define wxStrpbrk _tcspbrk
317 #define wxStrrchr _tcsrchr
318 #define wxStrspn _tcsspn
319 #define wxStrstr _tcsstr
320 #define wxStrtod _tcstod
321 #define wxStrtol _tcstol
322 #define wxStrtoul _tcstoul
323 #define wxStrxfrm _tcsxfrm
325 /* stdio.h functions */
326 #define wxFgetc _fgettc
327 #define wxFgetchar _fgettchar
328 #define wxFgets _fgetts
329 #if wxUSE_UNICODE_MSLU
330 #define wxFopen wxMSLU__tfopen
332 #define wxFopen _tfopen
334 #define wxFputc _fputtc
335 #define wxFputchar _fputtchar
336 #define wxFprintf _ftprintf
337 #define wxFputs _fputts
338 #define wxFreopen _tfreopen
339 #define wxFscanf _ftscanf
340 #define wxGetc _gettc
341 #define wxGetchar _gettchar
342 #define wxGets _getts
343 #define wxPerror _tperror
344 #define wxPrintf _tprintf
345 #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
346 #define wxPutchar _puttchar
347 #define wxPuts _putts
348 #define wxScanf _tscanf
351 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
352 int wxSprintf (wchar_t * __RESTRICT s
, const wchar_t * __RESTRICT format
, ... ) ;
354 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
355 #define wxSprintf sprintf
358 #define wxSprintf _stprintf
361 #define wxSscanf _stscanf
362 #define wxTmpnam _ttmpnam
363 #define wxUngetc _tungetc
364 #define wxVfprintf _vftprintf
365 #define wxVprintf _vtprintf
366 #define wxVsscanf _vstscanf
367 #define wxVsprintf _vstprintf
369 /* special case: not all TCHAR-aware compilers have those */
370 #if defined(__VISUALC__) || \
371 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
373 we can only use the system _vsntprintf() if we don't require the
374 Unix98 positional parameters support as it doesn't have it
376 #if !wxUSE_PRINTF_POS_PARAMS
377 #define wxVsnprintf_ _vsntprintf
378 #define wxSnprintf_ _sntprintf
382 /* special case: these functions are missing under Win9x with Unicows so we */
383 /* have to implement them ourselves */
384 #if wxUSE_UNICODE_MSLU
385 #define wxRemove wxMSLU__tremove
386 #define wxRename wxMSLU__trename
389 /* carefully: wxRemove() must return 0 on success while DeleteFile()
390 returns 0 on error, so don't just define one as the other */
391 int wxRemove(const wxChar
*path
);
393 #define wxRemove _tremove
394 #define wxRename _trename
398 /* stdlib.h functions */
401 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
402 /* there are no env vars at all under CE, so no _tgetenv neither */
404 /* can't define as inline function as this is a C file... */
405 #define wxGetenv(name) ((wxChar *)NULL)
407 #define wxGetenv _tgetenv
409 #define wxSystem _tsystem
411 /* time.h functions */
412 #define wxAsctime _tasctime
413 #define wxCtime _tctime
415 #define wxMbstowcs mbstowcs
416 #define wxWcstombs wcstombs
417 #else /* !TCHAR-aware compilers */
419 There are 2 unrelated problems with these functions under Mac:
420 a) Metrowerks MSL CRT implements them strictly in C99 sense and
421 doesn't support (very common) extension of allowing to call
422 mbstowcs(NULL, ...) which makes it pretty useless as you can't
423 know the size of the needed buffer
424 b) OS X <= 10.2 declares and even defined these functions but
425 doesn't really implement them -- they always return an error
427 So use our own replacements in both cases.
429 #if defined(__MWERKS__) && defined(__MSL__)
430 #define wxNEED_WX_MBSTOWCS
434 #if MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2
435 #define wxNEED_WX_MBSTOWCS
439 #ifdef wxNEED_WX_MBSTOWCS
440 /* even though they are defined and "implemented", they are bad and just
441 stubs so we need our own - we need these even in ANSI builds!! */
442 WXDLLIMPEXP_BASE
size_t wxMbstowcs (wchar_t *, const char *, size_t);
443 WXDLLIMPEXP_BASE
size_t wxWcstombs (char *, const wchar_t *, size_t);
445 #define wxMbstowcs mbstowcs
446 #define wxWcstombs wcstombs
450 The system C library on Mac OS X 10.2 and below does not support
451 unicode: in other words all wide-character functions such as towupper et
452 al. do simply not exist so we need to provide our own in that context,
453 except for the wchar_t definition/typedef itself.
455 We need to do this for both project builder and CodeWarrior as
456 the latter uses the system C library in Mach builds for wide character
457 support, which as mentioned does not exist on 10.2 and below.
459 #if wxUSE_UNICODE && \
460 defined(__DARWIN__) && \
461 ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
462 /* we need everything! */
463 #define wxNEED_WX_STRING_H
464 #define wxNEED_WX_CTYPE_H
466 #define wxFgetchar(c) wxFgetc(c, stdin)
467 #define wxFputc wxPutc
468 #define wxFputchar(c) wxPutc(c, stdout)
469 #define wxGetc wxFgetc
470 #define wxGetchar(c) wxFgetc(c, stdin)
477 #define wxNEED_UNGETC
483 int wxFputs(const wxChar
*ch
, FILE *stream
);
484 int wxPuts(const wxChar
*ws
);
485 int wxPutc(wxChar ch
, FILE *stream
);
490 WXDLLIMPEXP_BASE
size_t wxStrlen_(const wxChar
*s
);
495 #define wxPutchar(wch) wxPutc(wch, stdout)
497 #define wxNEED_PRINTF_CONVERSION
498 #define wxNEED_WX_STDIO_H
499 #define wxNEED_WX_STDLIB_H
500 #define wxNEED_WX_TIME_H
505 /* this is probably glibc-specific */
506 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
507 /* ctype.h functions (wctype.h) */
508 #define wxIsalnum iswalnum
509 #define wxIsalpha iswalpha
510 #define wxIscntrl iswcntrl
511 #define wxIsdigit iswdigit
512 #define wxIsgraph iswgraph
513 #define wxIslower iswlower
514 #define wxIsprint iswprint
515 #define wxIspunct iswpunct
516 #define wxIsspace iswspace
517 #define wxIsupper iswupper
518 #define wxIsxdigit iswxdigit
520 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
521 /* /usr/include/wctype.h incorrectly declares translations */
522 /* tables which provokes tons of compile-time warnings -- try */
523 /* to correct this */
524 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
525 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
526 #else /* !glibc 2.0 */
527 #define wxTolower towlower
528 #define wxToupper towupper
529 #endif /* gcc/!gcc */
531 /* string.h functions (wchar.h) */
532 #define wxStrcat wcscat
533 #define wxStrchr wcschr
534 #define wxStrcmp wcscmp
535 #define wxStrcoll wcscoll
536 #define wxStrcpy wcscpy
537 #define wxStrcspn wcscspn
538 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
539 #define wxStrncat wcsncat
540 #define wxStrncmp wcsncmp
541 #define wxStrncpy wcsncpy
542 #define wxStrpbrk wcspbrk
543 #define wxStrrchr wcsrchr
544 #define wxStrspn wcsspn
545 #define wxStrstr wcsstr
546 #define wxStrtod wcstod
547 #define wxStrtol wcstol
548 #define wxStrtoul wcstoul
549 #define wxStrxfrm wcsxfrm
551 #define wxFgetc fgetwc
552 #define wxFgetchar fgetwchar
553 #define wxFgets fgetws
554 #define wxFputc fputwc
555 #define wxFputchar fputwchar
557 #define wxGetchar getwchar
559 #define wxUngetc ungetwc
562 #define wxFputs fputws
566 int wxFputs(const wxChar
*ch
, FILE *stream
);
574 int wxPutc(wxChar ch
, FILE *stream
);
578 #define wxPutchar wputchar
580 #define wxPutchar(wch) wxPutc(wch, stdout)
587 int wxPuts(const wxChar
*ws
);
590 /* we need %s to %ls conversion for printf and scanf etc */
591 #define wxNEED_PRINTF_CONVERSION
593 /* glibc doesn't have wide char equivalents of the other stuff so */
594 /* use our own versions */
595 #define wxNEED_WX_STDIO_H
596 #define wxNEED_WX_STDLIB_H
597 #define wxNEED_WX_TIME_H
598 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
599 /* ctype.h functions (wctype.h) */
600 #define wxIsalnum iswalnum
601 #define wxIsalpha iswalpha
602 #define wxIscntrl iswcntrl
603 #define wxIsdigit iswdigit
604 #define wxIsgraph iswgraph
605 #define wxIslower iswlower
606 #define wxIsprint iswprint
607 #define wxIspunct iswpunct
608 #define wxIsspace iswspace
609 #define wxIsupper iswupper
610 #define wxIsxdigit iswxdigit
611 #define wxTolower towlower
612 #define wxToupper towupper
614 /* string.h functions (wchar.h) */
615 #define wxStrcat wcscat
616 #define wxStrchr wcschr
617 #define wxStrcmp wcscmp
618 #define wxStrcoll wcscoll
619 #define wxStrcpy wcscpy
620 #define wxStrcspn wcscspn
621 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
622 #define wxStrncat wcsncat
623 #define wxStrncmp wcsncmp
624 #define wxStrncpy wcsncpy
625 #define wxStrpbrk wcspbrk
626 #define wxStrrchr wcsrchr
627 #define wxStrspn wcsspn
628 #define wxStrstr wcsstr
629 #define wxStrtod wcstod
630 #define wxStrtol wcstol
631 #define wxStrtoul wcstoul
632 #define wxStrxfrm wcsxfrm
634 #define wxFgetc fgetwc
635 #define wxFgetchar fgetwchar
636 #define wxFgets fgetws
637 #define wxFputc fputwc
638 #define wxFputchar fputwchar
640 #define wxGetchar getwchar
642 #define wxUngetc ungetwc
644 #define wxNEED_PRINTF_CONVERSION
647 #define wxPutchar putwchar
648 #define wxFputs fputws
650 /* stdio.h functions */
652 #define wxNEED_WX_STDIO_H
654 /* stdlib.h functions */
656 #define wxNEED_WX_STDLIB_H
661 #define wxGetenv(a) ((wxChar*)NULL)
662 #define wxSystem(a) ((int)NULL)
664 /* time.h functions */
665 #define wxAsctime wasciitime
666 #define wxCtime wctime
667 /* #define wxStrftime wcsftime */
669 #define wxNEED_WX_TIME_H
670 #else /* !metrowerks for apple */
671 #error "Please define wide character functions for your environment"
677 /* ctype.h functions */
678 #define wxIsalnum isalnum
679 #define wxIsalpha isalpha
680 #define wxIscntrl iscntrl
681 #define wxIsdigit isdigit
682 #define wxIsgraph isgraph
683 #define wxIslower islower
684 #define wxIsprint isprint
685 #define wxIspunct ispunct
686 #define wxIsspace isspace
687 #define wxIsupper isupper
688 #define wxIsxdigit isxdigit
689 #define wxTolower tolower
690 #define wxToupper toupper
692 /* locale.h functons */
693 #define wxSetlocale setlocale
695 /* string.h functions */
696 #define wxStrcat strcat
697 #define wxStrchr strchr
698 #define wxStrcmp strcmp
699 #define wxStrcoll strcoll
700 #define wxStrcpy strcpy
701 #define wxStrcspn strcspn
703 /* wxStricmp and wxStrnicmp are defined below */
704 #define wxStrlen_ strlen /* used in wxStrlen inline function */
705 #define wxStrncat strncat
706 #define wxStrncmp strncmp
707 #define wxStrncpy strncpy
708 #define wxStrpbrk strpbrk
709 #define wxStrrchr strrchr
710 #define wxStrspn strspn
711 #define wxStrstr strstr
712 #define wxStrtod strtod
714 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
716 #define wxStrtol strtol
717 #define wxStrtoul strtoul
718 #define wxStrxfrm strxfrm
720 /* stdio.h functions */
721 #define wxFopen fopen
722 #define wxFreopen freopen
723 #define wxRemove remove
724 #define wxRename rename
726 #define wxPerror perror
727 #define wxTmpnam tmpnam
729 #define wxFgetc fgetc
730 #define wxFgetchar fgetchar
731 #define wxFgets fgets
732 #define wxFputc fputc
733 #define wxFputs fputs
734 #define wxFputchar fputchar
735 #define wxFprintf fprintf
736 #define wxFscanf fscanf
738 #define wxGetchar getchar
740 #define wxPrintf printf
742 #define wxPutchar putchar
744 #define wxScanf scanf
745 #define wxSprintf sprintf
746 #define wxSscanf sscanf
747 #define wxUngetc ungetc
748 #define wxVfprintf vfprintf
749 #define wxVprintf vprintf
750 #define wxVsscanf vsscanf
751 #define wxVsprintf vsprintf
753 /* stdlib.h functions */
757 #define wxGetenv getenv
758 #define wxSystem system
760 /* time.h functions */
761 #define wxAsctime asctime
762 #define wxCtime ctime
763 #define wxStrftime strftime
764 #endif /* Unicode/ASCII */
765 #endif /* TCHAR-aware compilers/the others */
768 various special cases
771 /* define wxStricmp and wxStrnicmp for various compilers */
773 /* note that in Unicode mode we definitely are going to need our own version */
774 #if !defined(wxStricmp) && !wxUSE_UNICODE
775 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
776 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
777 defined(__EMX__) || defined(__DJGPP__)
778 #define wxStricmp stricmp
779 #define wxStrnicmp strnicmp
780 #elif defined(__WXPALMOS__)
781 /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
782 * quick hack should do until one can be written.
784 #define wxStricmp StrCaselessCompare
785 #define wxStrnicmp strnicmp
786 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
787 (defined(__MWERKS__) && defined(__INTEL__))
788 #define wxStricmp _stricmp
789 #define wxStrnicmp _strnicmp
790 #elif defined(__UNIX__) || defined(__GNUWIN32__)
791 #define wxStricmp strcasecmp
792 #define wxStrnicmp strncasecmp
793 /* #else -- use wxWidgets implementation */
795 #endif /* !defined(wxStricmp) */
797 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
798 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
799 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
802 #define wxWcslen wcslen
804 WXDLLIMPEXP_BASE
size_t wxWcslen(const wchar_t *s
);
806 #endif /* wxUSE_WCHAR_T */
809 /* checks whether the passed in pointer is NULL and if the string is empty */
810 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
812 /* safe version of strlen() (returns 0 if passed NULL pointer) */
813 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
817 each of strdup() and wcsdup() may or may not be available but we need both
818 of them anyhow for wx/buffer.h so we define the missing one(s) in
819 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
820 defined -- if this is somehow not the case in some situations, please
821 correct that and not the lines here
824 #define wxStrdup wxStrdupW
826 #define wxStrdup wxStrdupA
830 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
833 /* printf() family saga */
836 For some systems [v]snprintf() exists in the system libraries but not in the
837 headers, so we need to declare it ourselves to be able to use it.
839 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
845 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
846 #endif /* !HAVE_VSNPRINTF_DECL */
848 #if defined(HAVE_SNPRINTF) && !defined(HAVE_SNPRINTF_DECL)
854 int snprintf(char *str
, size_t size
, const char *format
, ...);
855 #endif /* !HAVE_SNPRINTF_DECL */
857 /* Wrapper for vsnprintf if it's 3rd parameter is non-const. Note: the
858 * same isn't done for snprintf below, the builtin wxSnprintf_ is used
859 * instead since it's already a simple wrapper */
860 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
861 inline int wx_fixed_vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
)
863 return vsnprintf(str
, size
, (char*)format
, ap
);
868 First of all, we always want to define safe snprintf() function to be used
869 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
870 which we really need...), otherwise we implement it using our own printf()
873 We define function with a trailing underscore here because the real one is a
874 wrapper around it as explained below
876 #if !defined( wxVsnprintf_ ) && !wxUSE_PRINTF_POS_PARAMS
878 #ifdef wxHAVE_MWERKS_UNICODE
879 #define HAVE_WCSRTOMBS 1
880 #define HAVE_VSWPRINTF 1
881 #endif /* Metrowerks with Unicode support */
882 #if defined(__WATCOMC__)
883 #define wxVsnprintf_ _vsnwprintf
884 #define wxSnprintf_ _snwprintf
886 #if defined(HAVE__VSNWPRINTF) && defined(HAVE_UNIX98_PRINTF)
887 #define wxVsnprintf_ _vsnwprintf
888 /* MinGW?MSVCRT has the wrong vswprintf */
889 /* Mac OS X has a somehow buggy vswprintf */
890 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__) && !defined(__DARWIN__)
891 #define wxVsnprintf_ vswprintf
894 /* all versions of CodeWarrior supported by wxWidgets apparently have */
895 /* both snprintf() and vsnprintf() */
896 #if (defined(HAVE_SNPRINTF) && defined(HAVE_UNIX98_PRINTF)) \
897 || defined(__MWERKS__) || defined(__WATCOMC__)
898 #ifndef HAVE_BROKEN_SNPRINTF_DECL
899 #define wxSnprintf_ snprintf
902 #if (defined(HAVE_VSNPRINTF) && defined(HAVE_UNIX98_PRINTF)) \
903 || defined(__MWERKS__) || defined(__WATCOMC__)
904 #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
905 #define wxVsnprintf_ wx_fixed_vsnprintf
907 #define wxVsnprintf_ vsnprintf
911 #endif /* wxVsnprintf_ not defined yet */
914 /* no [v]snprintf(), cook our own */
915 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
916 ...) ATTRIBUTE_PRINTF_3
;
919 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
924 In Unicode mode we need to have all standard functions such as wprintf() and
925 so on but not all systems have them so use our own implementations in this
928 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
929 #define wxNEED_WPRINTF
933 More Unicode complications: although both ANSI C and C++ define a number of
934 wide character functions such as wprintf(), not all environments have them.
935 Worse, those which do have different behaviours: under Windows, %s format
936 specifier changes its meaning in Unicode build and expects a Unicode string
937 while under Unix/POSIX it still means an ASCII string even for wprintf() and
938 %ls has to be used for wide strings.
940 We choose to always emulate Windows behaviour as more useful for us so even
941 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
945 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
947 we need to implement all wide character printf and scanf functions
948 either because we don't have them at all or because they don't have the
952 #include <stdio.h> /* for FILE */
954 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
955 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
956 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
957 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
958 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
959 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
960 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
961 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
962 int wxVprintf( const wxChar
*format
, va_list ap
);
963 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
964 #endif /* wxNEED_PRINTF_CONVERSION */
966 /* these 2 can be simply mapped to the versions with underscore at the end */
967 /* if we don't have to do the conversion */
969 However, if we don't have any vswprintf() at all we don't need to redefine
970 anything as our own wxVsnprintf_() already behaves as needed.
972 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
973 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
974 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
976 #define wxSnprintf wxSnprintf_
977 #define wxVsnprintf wxVsnprintf_
981 various functions which might not be available in libc and for which we
982 provide our own replacements in wxchar.cpp
985 /* ctype.h functions */
987 /* RN: Used only under OSX <= 10.2 currently */
988 #ifdef wxNEED_WX_CTYPE_H
989 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
990 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
991 WXDLLIMPEXP_BASE
int wxIscntrl(wxChar ch
);
992 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
993 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
994 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
995 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
996 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
997 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
998 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
999 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
1000 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
1001 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
1002 #endif /* wxNEED_WX_CTYPE_H */
1004 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
1005 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
1006 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
1008 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
1012 a few compilers don't have the (non standard but common) isascii function,
1013 define it ourselves for them
1016 #if defined(__MWERKS__)
1017 #define wxNEED_ISASCII
1018 #elif defined(_WIN32_WCE)
1019 #if _WIN32_WCE <= 211
1020 #define wxNEED_ISASCII
1023 #endif /* isascii */
1025 #ifdef wxNEED_ISASCII
1026 inline int isascii(int c
) { return (unsigned)c
< 0x80; }
1030 #if _WIN32_WCE <= 211
1031 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
1033 #endif /* _WIN32_WCE */
1036 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
1037 initial versions of this header -- now it is too late to remove it so
1038 although we fixed the function/macro name above, still provide the
1039 backwards-compatible synonym.
1041 #define wxIsctrl wxIscntrl
1043 /* string.h functions */
1045 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
1046 #define wxNEED_STRDUP
1047 #elif defined(__WXWINCE__)
1048 #if _WIN32_WCE <= 211
1049 #define wxNEED_STRDUP
1054 #ifdef wxNEED_STRDUP
1055 WXDLLIMPEXP_BASE
char *strdup(const char* s
);
1058 /* RN: Used only under OSX <= 10.2 currently
1059 The __cplusplus ifdefs are messy, but they are required to build
1060 the regex library, since c does not support function overloading
1062 #ifdef wxNEED_WX_STRING_H
1066 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
1067 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
1068 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
1069 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
1070 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
1071 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
1072 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
1073 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
1074 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
1075 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
1076 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
1077 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
1078 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
1083 /* These functions use C++, so we can't c extern them */
1084 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
1085 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1086 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
1087 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
1089 /* inlined versions */
1091 inline wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
1092 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
1093 inline wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
1094 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
1095 inline wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
1096 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
1097 inline wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
1098 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
1101 #endif /* wxNEED_WX_STRING_H */
1104 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
1108 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
1112 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
1116 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
1120 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
1125 class WXDLLIMPEXP_BASE wxWCharBuffer
;
1126 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
1130 /* stdio.h functions */
1131 #ifdef wxNEED_WX_STDIO_H
1133 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
1134 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
1135 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
1136 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
1138 /* *printf() family is handled separately */
1139 #endif /* wxNEED_WX_STDIO_H */
1142 /* stdlib.h functions */
1144 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
1147 #ifdef wxNEED_WX_STDLIB_H
1148 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
1149 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
1150 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
1151 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
1155 /* time.h functions */
1156 #ifdef wxNEED_WX_TIME_H
1157 #if defined(__MWERKS__) && defined(macintosh)
1160 /*silent gabby compilers*/
1162 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
1163 const wxChar
*fmt
, const struct tm
*tm
);
1164 #endif /* wxNEED_WX_TIME_H */
1168 WXDLLIMPEXP_BASE wxChar
*wxCtime(const time_t *timep
);
1172 /* missing functions in some WinCE versions */
1174 #if (_WIN32_WCE < 300)
1175 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
1177 #endif /* _WIN32_WCE */
1179 /* multibyte to wide char conversion functions and macros */
1182 /* multibyte<->widechar conversion */
1183 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
1184 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
1187 #define wxMB2WX wxMB2WC
1188 #define wxWX2MB wxWC2MB
1189 #define wxWC2WX wxStrncpy
1190 #define wxWX2WC wxStrncpy
1192 #define wxMB2WX wxStrncpy
1193 #define wxWX2MB wxStrncpy
1194 #define wxWC2WX wxWC2MB
1195 #define wxWX2WC wxMB2WC
1197 #else /* !wxUSE_UNICODE */
1198 /* Why is this here?
1200 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1201 #define wxMB2WC wxStrncpy
1202 #define wxWC2MB wxStrncpy
1203 #define wxMB2WX wxStrncpy
1204 #define wxWX2MB wxStrncpy
1205 #define wxWC2WX wxWC2MB
1206 #define wxWX2WC wxMB2WC
1210 RN: The following are not normal versions of memcpy et al., rather
1211 these are either char or widechar versions depending on
1212 if unicode is used or not.
1218 // RN: We could do the usual tricky compiler detection here,
1219 // and use their variant (such as wmemchr, etc.). The problem
1220 // is that these functions are quite rare, even though they are
1221 // part of the current POSIX standard. In addition, most compilers
1222 // (including even MSC) inline them just like we do right in their
1226 #include <string.h> //for mem funcs
1228 //implement our own wmem variants
1229 inline wxChar
* wxTmemchr(const wxChar
* s
, wxChar c
, size_t l
)
1231 for(;l
&& *s
!= c
;--l
, ++s
) {}
1238 inline int wxTmemcmp(const wxChar
* sz1
, const wxChar
* sz2
, size_t len
)
1240 for(; *sz1
== *sz2
&& len
; --len
, ++sz1
, ++sz2
) {}
1243 return *sz1
< *sz2
? -1 : *sz1
> *sz2
;
1248 inline wxChar
* wxTmemcpy(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1250 return (wxChar
*) memcpy(szOut
, szIn
, len
* sizeof(wxChar
));
1253 inline wxChar
* wxTmemmove(wxChar
* szOut
, const wxChar
* szIn
, size_t len
)
1255 return (wxChar
*) memmove(szOut
, szIn
, len
* sizeof(wxChar
));
1258 inline wxChar
* wxTmemset(wxChar
* szOut
, const wxChar cIn
, size_t len
)
1260 wxChar
* szRet
= szOut
;
1268 #else /* !wxUSE_UNICODE */
1269 # define wxTmemchr memchr
1270 # define wxTmemcmp memcmp
1271 # define wxTmemcpy memcpy
1272 # define wxTmemmove memmove
1273 # define wxTmemset memset
1274 #endif /* wxUSE_UNICODE/!wxUSE_UNICODE */
1276 #endif /*__cplusplus*/
1279 #endif /* _WX_WXCHAR_H_ */