1 /////////////////////////////////////////////////////////////////////////////
3 // Purpose: Declarations common to wx char/wchar_t usage (wide chars)
8 // Copyright: (c) wxWindows copyright
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
16 #pragma interface "wxchar.h"
19 // only do SBCS or _UNICODE
21 // It may be OK anyway.
22 // # error "MBCS is not supported by wxChar"
25 // ----------------------------------------------------------------------------
26 // first deal with Unicode setting
27 // ----------------------------------------------------------------------------
29 // set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined
30 #if defined(_UNICODE) || defined(UNICODE)
32 # define wxUSE_UNICODE 1
34 # ifndef wxUSE_UNICODE
35 # define wxUSE_UNICODE 0
39 // and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1...
49 // Unicode support requires wchar_t
52 # define wxUSE_WCHAR_T 1
55 // ----------------------------------------------------------------------------
56 // define wxHAVE_TCHAR_FUNCTIONS for the compilers which support the
57 // wide-character functions
58 // ----------------------------------------------------------------------------
61 // VC++ and BC++ starting with 5.2 have TCHAR support
63 #define wxHAVE_TCHAR_FUNCTIONS
64 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
65 #define wxHAVE_TCHAR_FUNCTIONS
66 #elif defined(__GNUWIN32__) && wxCHECK_W32API_VERSION( 1, 0 )
67 #define wxHAVE_TCHAR_FUNCTIONS
71 #elif defined(__CYGWIN__)
75 #elif defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
76 // VisualAge 4.0+ supports TCHAR
77 #define wxHAVE_TCHAR_FUNCTIONS
79 // but not stdio.h nor time nor conversion functions
80 #define wxNO_TCHAR_STDIO
81 #define wxNO_TCHAR_STDLIB
82 #define wxNO_TCHAR_TIME
83 #define wxNO_TCHAR_LOCALE
85 // supplemental VA V4 defs so at least we know what these are
86 // just define to standard defs
92 // locale.h functons -- not defined in tchar.h
93 #define wxSetlocale setlocale
94 // some stdio functions are defined others are not
96 #define wxFgetchar fgetchar
98 #define wxFputchar fputchar
99 #define wxFreopen freopen
101 #define wxPerror perror
103 #define wxRemove remove
104 #define wxRename rename
105 #define wxTmpnam tmpnam
106 #define wxUngetc ungetc
107 #define wxVsscanf vsscanf
108 // stdlib not defined in VA V4
114 #define wxGetenv getenv
115 #define wxSystem system
116 // time.h functions -- none defined in tchar.h
117 #define wxAsctime asctime
118 #define wxCtime ctime
119 #elif defined(__MWERKS__)
124 #endif // compilers with (good) TCHAR support
126 #ifdef wxHAVE_TCHAR_FUNCTIONS
127 # define HAVE_WCSLEN 1
131 # if wxUSE_UNICODE // temporary - preserve binary compatibility
132 #if defined(__GNUWIN32__)
134 #define _TSCHAR TCHAR
135 #define _TUCHAR TCHAR
138 typedef _TCHAR wxChar
;
139 typedef _TSCHAR wxSChar
;
140 typedef _TUCHAR wxUChar
;
143 # define wxSChar signed char
144 # define wxUChar unsigned char
147 // wchar_t is available
148 #ifndef wxUSE_WCHAR_T
149 #define wxUSE_WCHAR_T 1
150 #endif // !defined(wxUSE_WCHAR_T)
153 #ifndef wxNO_TCHAR_CTYPE
157 # define wxIsalnum _istalnum
158 # define wxIsalpha _istalpha
159 # define wxIsctrl _istctrl
160 # define wxIsdigit _istdigit
161 # define wxIsgraph _istgraph
162 # define wxIslower _istlower
163 # define wxIsprint _istprint
164 # define wxIspunct _istpunct
165 # define wxIsspace _istspace
166 # define wxIsupper _istupper
167 # define wxIsxdigit _istxdigit
168 # define wxTolower _totlower
169 # define wxToupper _totupper
170 #endif // wxNO_TCHAR_CTYPE
173 #ifndef wxNO_TCHAR_LOCALE
174 # define wxSetlocale _tsetlocale
175 #endif // wxNO_TCHAR_LOCALE
177 // string.h functions
178 #ifndef wxNO_TCHAR_STRING
179 # define wxStrcat _tcscat
180 # define wxStrchr _tcschr
181 # define wxStrcmp _tcscmp
182 # define wxStrcoll _tcscoll
183 # define wxStrcpy _tcscpy
184 # define wxStrcspn _tcscspn
185 # define wxStrftime _tcsftime
186 # define wxStricmp _tcsicmp
187 # define wxStrnicmp _tcsnicmp
188 # define wxStrlen_ _tcslen // used in wxStrlen inline function
189 # define wxStrncat _tcsncat
190 # define wxStrncmp _tcsncmp
191 # define wxStrncpy _tcsncpy
192 # define wxStrpbrk _tcspbrk
193 # define wxStrrchr _tcsrchr
194 # define wxStrspn _tcsspn
195 # define wxStrstr _tcsstr
196 # define wxStrtod _tcstod
197 # define wxStrtol _tcstol
198 # define wxStrtoul _tcstoul
199 # define wxStrxfrm _tcsxfrm
200 #endif // wxNO_TCHAR_STRING
203 #ifndef wxNO_TCHAR_STDIO
204 # define wxFgetc _fgettc
205 # define wxFgetchar _fgettchar
206 # define wxFgets _fgetts
207 # define wxFopen _tfopen
208 # define wxFputc _fputtc
209 # define wxFputchar _fputtchar
210 # define wxFprintf _ftprintf
211 # define wxFreopen _tfreopen
212 # define wxFscanf _ftscanf
213 # define wxGetc _gettc
214 # define wxGetchar _gettchar
215 # define wxGets _getts
216 # define wxPerror _tperror
217 # define wxPrintf _tprintf
218 # define wxPutc _puttc
219 # define wxPutchar _puttchar
220 # define wxPuts _putts
221 # define wxRemove _tremove
222 # define wxRename _trename
223 # define wxScanf _tscanf
224 # define wxSprintf _stprintf
225 # define wxSscanf _stscanf
226 # define wxTmpnam _ttmpnam
227 # define wxUngetc _tungetc
228 # define wxVfprint _vftprintf
229 # define wxVprintf _vtprintf
230 # define wxVsscanf _vstscanf
231 # define wxVsprintf _vstprintf
232 #elif defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
233 // it has some stdio.h functions, apparently
234 # define wxFgetc _fgettc
235 # define wxFgets _fgetts
236 # define wxFputc _fputtc
237 # define wxFprintf _ftprintf
238 # define wxFscanf _ftscanf
239 # define wxGetc _gettc
240 # define wxGetchar _gettchar
241 # define wxPrintf _tprintf
242 # define wxPutc _puttc
243 # define wxPutchar _puttchar
244 # define wxScanf _tscanf
245 # define wxSprintf _stprintf
246 # define wxSscanf _stscanf
247 # define wxVfprint _vftprintf
248 # define wxVprintf _vtprintf
249 # define wxVsprintf _vstprintf
250 #endif // wxNO_TCHAR_STDIO
252 // stdlib.h functions
253 #ifndef wxNO_TCHAR_STDLIB
257 # define wxAtoi _ttoi
258 # define wxAtol _ttol
259 # define wxGetenv _tgetenv
260 # define wxSystem _tsystem
261 #endif // wxNO_TCHAR_STDLIB
264 #ifndef wxNO_TCHAR_TIME
265 # define wxAsctime _tasctime
266 # define wxCtime _tctime
267 #endif // wxNO_TCHAR_TIME
269 #else // !TCHAR-aware compilers
271 // check whether we should include wchar.h or equivalent
272 # if !defined(wxUSE_WCHAR_T)
273 # if defined(__VISUALC__) && (__VISUALC__ < 900)
274 # define wxUSE_WCHAR_T 0 // wchar_t is not available for MSVC++ 1.5
275 # elif defined(__UNIX__)
276 # if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || (defined(__DARWIN__))
277 # define wxUSE_WCHAR_T 1
279 # define wxUSE_WCHAR_T 0
281 # elif defined(__GNUWIN32__) && !defined(__MINGW32__) // Cygwin (not Mingw32) doesn't have wcslen.h, needed in buffer.h
282 # define wxUSE_WCHAR_T 0
283 # elif defined(__BORLANDC__) // WIN16 BC++
284 # define wxUSE_WCHAR_T 0
285 # elif defined(__WATCOMC__)
286 # define wxUSE_WCHAR_T 0
287 # elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
288 # define wxUSE_WCHAR_T 0
290 // add additional compiler checks if this fails
291 # define wxUSE_WCHAR_T 1
293 # endif // !defined(wxUSE_WCHAR_T)
299 // VZ: do we really have to include this?
302 // include wchar.h to get wcslen() declaration used by wx/buffer.h
303 # if defined(HAVE_WCHAR_H)
309 // check whether we are doing Unicode
314 // this is probably glibc-specific
315 # if defined(__WCHAR_TYPE__)
317 typedef __WCHAR_TYPE__ wxChar
;
318 typedef signed __WCHAR_TYPE__ wxSChar
;
319 typedef unsigned __WCHAR_TYPE__ wxUChar
;
323 // ctype.h functions (wctype.h)
324 # define wxIsalnum iswalnum
325 # define wxIsalpha iswalpha
326 # define wxIsctrl iswcntrl
327 # define wxIsdigit iswdigit
328 # define wxIsgraph iswgraph
329 # define wxIslower iswlower
330 # define wxIsprint iswprint
331 # define wxIspunct iswpunct
332 # define wxIsspace iswspace
333 # define wxIsupper iswupper
334 # define wxIsxdigit iswxdigit
336 # if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
337 // /usr/include/wctype.h incorrectly declares translations tables which
338 // provokes tons of compile-time warnings - try to correct this
339 # define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
340 # define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
342 # define wxTolower towlower
343 # define wxToupper towupper
346 // string.h functions (wchar.h)
347 # define wxStrcat wcscat
348 # define wxStrchr wcschr
349 # define wxStrcmp wcscmp
350 # define wxStrcoll wcscoll
351 # define wxStrcpy wcscpy
352 # define wxStrcspn wcscspn
353 # define wxStrlen_ wcslen // used in wxStrlen inline function
354 # define wxStrncat wcsncat
355 # define wxStrncmp wcsncmp
356 # define wxStrncpy wcsncpy
357 # define wxStrpbrk wcspbrk
358 # define wxStrrchr wcsrchr
359 # define wxStrspn wcsspn
360 # define wxStrstr wcsstr
361 # define wxStrtod wcstod
362 # define wxStrtok wcstok
363 # define wxStrtol wcstol
364 # define wxStrtoul wcstoul
365 # define wxStrxfrm wcsxfrm
367 // glibc doesn't have wc equivalents of the other stuff
368 # define wxNEED_WX_STDIO_H
369 # define wxNEED_WX_STDLIB_H
370 # define wxNEED_WX_TIME_H
373 # error "Please define your compiler's Unicode conventions in wxChar.h"
380 # if 0 // temporary - preserve binary compatibilty
382 typedef signed char wxSChar
;
383 typedef unsigned char wxUChar
;
386 # define wxSChar signed char
387 # define wxUChar unsigned char
390 # if defined(__FreeBSD__) || defined(__DARWIN__)
394 # if !defined(__MINGW32__) || !defined(_T)
399 # define wxIsalnum isalnum
400 # define wxIsalpha isalpha
401 # define wxIsctrl isctrl
402 # define wxIsdigit isdigit
403 # define wxIsgraph isgraph
404 # define wxIslower islower
405 # define wxIsprint isprint
406 # define wxIspunct ispunct
407 # define wxIsspace isspace
408 # define wxIsupper isupper
409 # define wxIsxdigit isxdigit
410 # define wxTolower tolower
411 # define wxToupper toupper
414 # define wxSetlocale setlocale
416 // string.h functions
417 // #define wxStricmp strcasecmp
418 // wxStricmp is defined below!!
421 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
423 #define wxStrtok(str, sep, last) strtok(str, sep)
426 // leave the rest to defaults below
427 # define wxNEED_WX_STRING_H
428 # define wxNEED_WX_STDIO_H
429 # define wxNEED_WX_STDLIB_H
430 # define wxNEED_WX_TIME_H
433 #endif//TCHAR-aware compilers
435 // define wxStricmp for various compilers without Unicode possibilities
436 #if !defined(wxStricmp) && !wxUSE_UNICODE
437 # if defined(__BORLANDC__) || defined(__WATCOMC__) || defined(__SALFORDC__) || defined(__VISAGECPP__) || defined(__EMX__)
438 # define wxStricmp stricmp
439 # define wxStrnicmp strnicmp
440 # elif defined(__SC__) || defined(__VISUALC__) || (defined(__MWERKS__) && defined(__INTEL__))
441 # define wxStricmp _stricmp
442 # define wxStrnicmp _strnicmp
443 # elif defined(__UNIX__) || defined(__GNUWIN32__)
444 # define wxStricmp strcasecmp
445 # define wxStrnicmp strncasecmp
446 # elif defined(__MWERKS__) && !defined(__INTEL__)
447 // use wxWindows' implementation
449 // if you leave wxStricmp undefined, wxWindows' implementation will be used
450 # error "Please define string case-insensitive compare for your OS/compiler"
454 // if we need to define for standard headers, and we're not using Unicode,
455 // just define to standard C library routines
457 # ifdef wxNEED_WX_STRING_H
458 # define wxStrcat strcat
459 # define wxStrchr strchr
460 # define wxStrcmp strcmp
461 # define wxStrcoll strcoll
462 # define wxStrcpy strcpy
463 # define wxStrcspn strcspn
464 # define wxStrdup strdup
465 # define wxStrlen_ strlen // used in wxStrlen inline function
466 # define wxStrncat strncat
467 # define wxStrncmp strncmp
468 # define wxStrncpy strncpy
469 # define wxStrpbrk strpbrk
470 # define wxStrrchr strrchr
471 # define wxStrspn strspn
472 # define wxStrstr strstr
473 # define wxStrtod strtod
474 # define wxStrtol strtol
475 # define wxStrtoul strtoul
476 # define wxStrxfrm strxfrm
477 # undef wxNEED_WX_STRING_H
480 # ifdef wxNEED_WX_STDIO_H
481 # define wxFgetc fgetc
482 # define wxFgetchar fgetchar
483 # define wxFgets fgets
484 # define wxFopen fopen
485 # define wxFputc fputc
486 # define wxFputchar fputchar
487 # define wxFprintf fprintf
488 # define wxFreopen freopen
489 # define wxFscanf fscanf
491 # define wxGetchar getchar
493 # define wxPerror perror
494 # define wxPrintf printf
496 # define wxPutchar putchar
498 # define wxRemove remove
499 # define wxRename rename
500 # define wxScanf scanf
501 # define wxSprintf sprintf
502 # define wxSscanf sscanf
503 # define wxTmpnam tmpnam
504 # define wxUngetc ungetc
505 # define wxVfprint vfprintf
506 # define wxVprintf vprintf
507 # define wxVsscanf vsscanf
508 # define wxVsprintf vsprintf
509 # undef wxNEED_WX_STDIO_H
512 # ifdef wxNEED_WX_STDLIB_H
516 # define wxGetenv getenv
517 # define wxSystem system
518 # undef wxNEED_WX_STDLIB_H
521 # ifdef wxNEED_WX_TIME_H
522 # define wxAsctime asctime
523 # define wxCtime ctime
524 # define wxStrftime strftime
525 # undef wxNEED_WX_TIME_H
529 // checks whether the passed in pointer is NULL and if the string is empty
530 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
532 #ifndef wxNEED_WX_STRING_H
533 // safe version of strlen() (returns 0 if passed NULL pointer)
534 inline size_t wxStrlen(const wxChar
*psz
)
535 { return psz
? wxStrlen_(psz
) : 0; }
539 // multibyte<->widechar conversion
540 WXDLLEXPORT
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
541 WXDLLEXPORT
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
543 # define wxMB2WX wxMB2WC
544 # define wxWX2MB wxWC2MB
545 # define wxWC2WX wxStrncpy
546 # define wxWX2WC wxStrncpy
548 # define wxMB2WX wxStrncpy
549 # define wxWX2MB wxStrncpy
550 # define wxWC2WX wxWC2MB
551 # define wxWX2WC wxMB2WC
554 // No wxUSE_WCHAR_T: we have to do something (JACS)
555 # define wxMB2WC wxStrncpy
556 # define wxWC2MB wxStrncpy
557 # define wxMB2WX wxStrncpy
558 # define wxWX2MB wxStrncpy
559 # define wxWC2WX wxWC2MB
560 # define wxWX2WC wxMB2WC
563 WXDLLEXPORT
bool wxOKlibc(); // for internal use
565 // if libc versions are not available, use replacements defined in wxchar.cpp
567 WXDLLEXPORT wxChar
* wxStrdup(const wxChar
*psz
);
571 WXDLLEXPORT
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
575 WXDLLEXPORT
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
579 WXDLLEXPORT wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
584 WXDLLEXPORT wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
587 #ifdef wxNEED_WX_CTYPE_H
588 WXDLLEXPORT
int wxIsalnum(wxChar ch
);
589 WXDLLEXPORT
int wxIsalpha(wxChar ch
);
590 WXDLLEXPORT
int wxIsctrl(wxChar ch
);
591 WXDLLEXPORT
int wxIsdigit(wxChar ch
);
592 WXDLLEXPORT
int wxIsgraph(wxChar ch
);
593 WXDLLEXPORT
int wxIslower(wxChar ch
);
594 WXDLLEXPORT
int wxIsprint(wxChar ch
);
595 WXDLLEXPORT
int wxIspunct(wxChar ch
);
596 WXDLLEXPORT
int wxIsspace(wxChar ch
);
597 WXDLLEXPORT
int wxIsupper(wxChar ch
);
598 WXDLLEXPORT
int wxIsxdigit(wxChar ch
);
599 WXDLLEXPORT
int wxTolower(wxChar ch
);
600 WXDLLEXPORT
int wxToupper(wxChar ch
);
603 #ifdef wxNEED_WX_STRING_H
604 WXDLLEXPORT wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
605 WXDLLEXPORT wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
606 WXDLLEXPORT
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
607 WXDLLEXPORT
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
608 WXDLLEXPORT wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
609 WXDLLEXPORT
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
610 WXDLLEXPORT
size_t wxStrlen(const wxChar
*s
);
611 WXDLLEXPORT wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
612 WXDLLEXPORT
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
613 WXDLLEXPORT wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
614 WXDLLEXPORT wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
615 WXDLLEXPORT wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
616 WXDLLEXPORT
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
617 WXDLLEXPORT wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
618 WXDLLEXPORT
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
619 WXDLLEXPORT
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
620 WXDLLEXPORT
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
621 WXDLLEXPORT
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
624 #ifdef wxNEED_WX_STDIO_H
627 WXDLLEXPORT
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
628 WXDLLEXPORT
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
629 WXDLLEXPORT
int wxRemove(const wxChar
*path
);
630 WXDLLEXPORT
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
631 WXDLLEXPORT
int wxPrintf(const wxChar
*fmt
, ...);
632 WXDLLEXPORT
int wxVprintf(const wxChar
*fmt
, va_list argptr
);
633 WXDLLEXPORT
int wxFprintf(FILE *stream
, const wxChar
*fmt
, ...);
634 WXDLLEXPORT
int wxVfprintf(FILE *stream
, const wxChar
*fmt
, va_list argptr
);
635 WXDLLEXPORT
int wxSprintf(wxChar
*buf
, const wxChar
*fmt
, ...);
636 WXDLLEXPORT
int wxVsprintf(wxChar
*buf
, const wxChar
*fmt
, va_list argptr
);
637 WXDLLEXPORT
int wxSscanf(const wxChar
*buf
, const wxChar
*fmt
, ...);
638 WXDLLEXPORT
int wxVsscanf(const wxChar
*buf
, const wxChar
*fmt
, va_list argptr
);
642 WXDLLEXPORT
double wxAtof(const wxChar
*psz
);
645 #ifdef wxNEED_WX_STDLIB_H
646 WXDLLEXPORT
int wxAtoi(const wxChar
*psz
);
647 WXDLLEXPORT
long wxAtol(const wxChar
*psz
);
648 WXDLLEXPORT wxChar
* wxGetenv(const wxChar
*name
);
649 WXDLLEXPORT
int wxSystem(const wxChar
*psz
);
652 #ifdef wxNEED_WX_TIME_H
653 WXDLLEXPORT
size_t wxStrftime(wxChar
*s
, size_t max
, const wxChar
*fmt
, const struct tm
*tm
);
656 // under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks
657 // the file parsing - this may be true for 5.0 as well, update #ifdef then
658 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
660 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
663 // ----------------------------------------------------------------------------
664 // common macros which are always defined
665 // ----------------------------------------------------------------------------
667 // although global macros with such names are really bad, we want to have
668 // another name for _T() which should be used to avoid confusion between _T()
669 // and _() in wxWindows sources
672 // a Unicode-friendly __FILE__ analog
674 #define __XFILE__(x) wxT(x)
675 #define __TFILE__ __XFILE__(__FILE__)