]>
git.saurik.com Git - wxWidgets.git/blob - include/wx/wxchar.h
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 #error "MBCS is not supported by wxChar"
24 // set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined
25 #if defined(_UNICODE) || defined(UNICODE)
27 #define wxUSE_UNICODE 1
30 #define wxUSE_UNICODE 0
34 // and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1...
44 // Windows (VC++) has broad TCHAR support
45 #if defined(__VISUALC__) && defined(__WIN32__)
50 #if wxUSE_UNICODE // temporary - preserve binary compatibility
51 typedef _TCHAR wxChar
;
52 typedef _TSCHAR wxSChar
;
53 typedef _TUCHAR wxUChar
;
56 #define wxSChar signed char
57 #define wxUChar unsigned char
59 // wchar_t is available
61 #define wxUSE_WCHAR_T 1
64 #define wxIsalnum _istalnum
65 #define wxIsalpha _istalpha
66 #define wxIsctrl _istctrl
67 #define wxIsdigit _istdigit
68 #define wxIsgraph _istgraph
69 #define wxIslower _istlower
70 #define wxIsprint _istprint
71 #define wxIspunct _istpunct
72 #define wxIsspace _istspace
73 #define wxIsupper _istupper
74 #define wxIsxdigit _istxdigit
75 #define wxTolower _totlower
76 #define wxToupper _totupper
79 #define wxSetlocale _tsetlocale
82 #define wxStrcat _tcscat
83 #define wxStrchr _tcschr
84 #define wxStrcmp _tcscmp
85 #define wxStrcoll _tcscoll
86 #define wxStrcpy _tcscpy
87 #define wxStrcspn _tcscspn
88 #define wxStrftime _tcsftime
89 #define wxStricmp _tcsicmp
90 #define wxStrlen_ _tcslen // used in wxStrlen inline function
91 #define wxStrncat _tcsncat
92 #define wxStrncmp _tcsncmp
93 #define wxStrncpy _tcsncpy
94 #define wxStrpbrk _tcspbrk
95 #define wxStrrchr _tcsrchr
96 #define wxStrspn _tcsspn
97 #define wxStrstr _tcsstr
98 #define wxStrtod _tcstod
99 // is there a _tcstok[_r] ?
100 #define wxStrtol _tcstol
101 #define wxStrtoul _tcstoul
102 #define wxStrxfrm _tcsxfrm
105 #define wxFgetc _fgettc
106 #define wxFgetchar _fgettchar
107 #define wxFgets _fgetts
108 #define wxFopen _tfopen
109 #define wxFputc _fputtc
110 #define wxFputchar _fputtchar
111 #define wxFprintf _ftprintf
112 #define wxFreopen _tfreopen
113 #define wxFscanf _ftscanf
114 #define wxGetc _gettc
115 #define wxGetchar _gettchar
116 #define wxGets _getts
117 #define wxPerror _tperror
118 #define wxPrintf _tprintf
119 #define wxPutc _puttc
120 #define wxPutchar _puttchar
121 #define wxPuts _putts
122 #define wxRemove _tremove
123 #define wxRename _trename
124 #define wxScanf _tscanf
125 #define wxSprintf _stprintf
126 #define wxSscanf _stscanf
127 #define wxTmpnam _ttmpnam
128 #define wxUngetc _tungetc
129 #define wxVfprint _vftprintf
130 #define wxVprintf _vtprintf
131 #define wxVsscanf _vstscanf
132 #define wxVsprintf _vstprintf
134 // stdlib.h functions
140 #define wxGetenv _tgetenv
141 #define wxSystem _tsystem
144 #define wxAsctime _tasctime
145 #define wxCtime _tctime
147 // #elif defined(XXX)
148 // #include XXX-specific files here
149 // typeddef YYY wxChar;
151 // translate wxZZZ names
153 #elif defined(__BORLANDC__) && defined(__WIN32__)
155 // Borland C++ 4.52 doesn't have much tchar support
156 // maybe Borland C++ 5.02 has, can't check right now
157 // but I'll use the Win32 API instead here
160 #if wxUSE_UNICODE // temporary - preserve binary compatibility
161 typedef _TCHAR wxChar
;
162 typedef _TSCHAR wxSChar
;
163 typedef _TUCHAR wxUChar
;
166 #define wxSChar signed char
167 #define wxUChar unsigned char
169 // wchar_t is available
171 #define wxUSE_WCHAR_T 1
173 #define wxNEED_WX_CTYPE_H
174 // #define wxStrtok strtok_r // Borland C++ 4.52 doesn't have strtok_r
175 #define wxNEED_WX_STRING_H
176 #define wxNEED_WX_STDIO_H
177 #define wxNEED_WX_STDLIB_H
178 #define wxNEED_WX_TIME_H
179 #define wxNEED_WCSLEN
181 #else//!TCHAR-aware compilers
183 // check whether we should include wchar.h or equivalent
186 #define wxUSE_WCHAR_T 1 // wchar_t *must* be available in Unicode mode
187 #elif !defined(wxUSE_WCHAR_T)
188 #if defined(__VISUALC__) && (__VISUALC__ < 900)
189 #define wxUSE_WCHAR_T 0 // wchar_t is not available for MSVC++ 1.5
190 #elif defined(__UNIX__)
191 #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__)
192 #define wxUSE_WCHAR_T 1
194 #define wxUSE_WCHAR_T 0
196 #elif defined(__GNUWIN32__) && !defined(__MINGW32__) // Cygwin (not Mingw32) doesn't have wcslen.h, needed in buffer.h
197 #define wxUSE_WCHAR_T 0
198 #elif defined(__BORLANDC__) // WIN16 BC++
199 #define wxUSE_WCHAR_T 0
200 #elif defined(__WATCOMC__)
201 #define wxUSE_WCHAR_T 0
203 // add additional compiler checks if this fails
204 #define wxUSE_WCHAR_T 1
206 #endif//wxUSE_UNICODE
216 #define wxNEED_WCSLEN
221 // check whether we are doing Unicode
226 // this is probably glibc-specific
227 #if defined(__WCHAR_TYPE__)
229 typedef __WCHAR_TYPE__ wxChar
;
230 typedef signed __WCHAR_TYPE__ wxSChar
;
231 typedef unsigned __WCHAR_TYPE__ wxUChar
;
235 // ctype.h functions (wctype.h)
236 #define wxIsalnum iswalnum
237 #define wxIsalpha iswalpha
238 #define wxIsctrl iswcntrl
239 #define wxIsdigit iswdigit
240 #define wxIsgraph iswgraph
241 #define wxIslower iswlower
242 #define wxIsprint iswprint
243 #define wxIspunct iswpunct
244 #define wxIsspace iswspace
245 #define wxIsupper iswupper
246 #define wxIsxdigit iswxdigit
248 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
249 // /usr/include/wctype.h incorrectly declares translations tables which
250 // provokes tons of compile-time warnings - try to correct this
251 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
252 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
254 #define wxTolower towlower
255 #define wxToupper towupper
258 // string.h functions (wchar.h)
259 #define wxStrcat wcscat
260 #define wxStrchr wcschr
261 #define wxStrcmp wcscmp
262 #define wxStrcoll wcscoll
263 #define wxStrcpy wcscpy
264 #define wxStrcspn wcscspn
265 #define wxStrlen_ wcslen // used in wxStrlen inline function
266 #define wxStrncat wcsncat
267 #define wxStrncmp wcsncmp
268 #define wxStrncpy wcsncpy
269 #define wxStrpbrk wcspbrk
270 #define wxStrrchr wcsrchr
271 #define wxStrspn wcsspn
272 #define wxStrstr wcsstr
273 #define wxStrtod wcstod
274 #define wxStrtok wcstok
275 #define wxStrtol wcstol
276 #define wxStrtoul wcstoul
277 #define wxStrxfrm wcsxfrm
279 // glibc doesn't have wc equivalents of the other stuff
280 #define wxNEED_WX_STDIO_H
281 #define wxNEED_WX_STDLIB_H
282 #define wxNEED_WX_TIME_H
285 #error "Please define your compiler's Unicode conventions in wxChar.h"
292 #if 0 // temporary - preserve binary compatibilty
294 typedef signed char wxSChar
;
295 typedef unsigned char wxUChar
;
298 #define wxSChar signed char
299 #define wxUChar unsigned char
308 #define wxIsalnum isalnum
309 #define wxIsalpha isalpha
310 #define wxIsctrl isctrl
311 #define wxIsdigit isdigit
312 #define wxIsgraph isgraph
313 #define wxIslower islower
314 #define wxIsprint isprint
315 #define wxIspunct ispunct
316 #define wxIsspace isspace
317 #define wxIsupper isupper
318 #define wxIsxdigit isxdigit
319 #define wxTolower tolower
320 #define wxToupper toupper
323 #define wxSetlocale setlocale
325 // string.h functions
326 // #define wxStricmp strcasecmp
328 // Taken from string.h since it tests for platform more correctly
329 // portable strcasecmp/_stricmp
330 inline int WXDLLEXPORT
wxStricmp(const char *psz1
, const char *psz2
)
332 #if defined(__VISUALC__) || ( defined(__MWERKS__) && defined(__INTEL__) )
333 return _stricmp(psz1
, psz2
);
334 #elif defined(__SC__)
335 return _stricmp(psz1
, psz2
);
336 #elif defined(__SALFORDC__)
337 return stricmp(psz1
, psz2
);
338 #elif defined(__BORLANDC__)
339 return stricmp(psz1
, psz2
);
340 #elif defined(__WATCOMC__)
341 return stricmp(psz1
, psz2
);
342 #elif defined(__UNIX__) || defined(__GNUWIN32__)
343 return strcasecmp(psz1
, psz2
);
344 #elif defined(__MWERKS__) && !defined(__INTEL__)
345 register char c1
, c2
;
347 c1
= tolower(*psz1
++);
348 c2
= tolower(*psz2
++);
349 } while ( c1
&& (c1
== c2
) );
353 // almost all compilers/libraries provide this function (unfortunately under
354 // different names), that's why we don't implement our own which will surely
355 // be more efficient than this code (uncomment to use):
357 register char c1, c2;
359 c1 = tolower(*psz1++);
360 c2 = tolower(*psz2++);
361 } while ( c1 && (c1 == c2) );
366 #error "Please define string case-insensitive compare for your OS/compiler"
367 #endif // OS/compiler
370 // #define wxStrtok strtok_r // this needs a configure check
372 // leave the rest to defaults below
373 #define wxNEED_WX_STRING_H
374 #define wxNEED_WX_STDIO_H
375 #define wxNEED_WX_STDLIB_H
376 #define wxNEED_WX_TIME_H
379 #endif//TCHAR-aware compilers
381 // define wxStricmp for various compilers without Unicode possibilities
382 #if !defined(wxStricmp) && !wxUSE_UNICODE
383 #if defined(__BORLANDC__) || defined(__WATCOMC__) || defined(__SALFORDC__)
384 #define wxStricmp stricmp
385 #elif defined(__SC__) || defined(__VISUALC__) || (defined(__MWERKS) && defined(__INTEL__))
386 #define wxStricmp _stricmp
387 #elif defined(__UNIX__) || defined(__GNUWIN32__)
388 #define wxStricmp strcasecmp
389 #elif defined(__MWERKS__) && !defined(__INTEL__)
390 // use wxWindows' implementation
392 // if you leave wxStricmp undefined, wxWindows' implementation will be used
393 #error "Please define string case-insensitive compare for your OS/compiler"
397 // if we need to define for standard headers, and we're not using Unicode,
398 // just define to standard C library routines
400 #ifdef wxNEED_WX_STRING_H
401 #define wxStrcat strcat
402 #define wxStrchr strchr
403 #define wxStrcmp strcmp
404 #define wxStrcoll strcoll
405 #define wxStrcpy strcpy
406 #define wxStrcspn strcspn
407 #define wxStrdup strdup
408 #define wxStrlen_ strlen // used in wxStrlen inline function
409 #define wxStrncat strncat
410 #define wxStrncmp strncmp
411 #define wxStrncpy strncpy
412 #define wxStrpbrk strpbrk
413 #define wxStrrchr strrchr
414 #define wxStrspn strspn
415 #define wxStrstr strstr
416 #define wxStrtod strtod
417 #define wxStrtol strtol
418 #define wxStrtoul strtoul
419 #define wxStrxfrm strxfrm
420 #undef wxNEED_WX_STRING_H
423 #ifdef wxNEED_WX_STDIO_H
424 #define wxFgetc fgetc
425 #define wxFgetchar fgetchar
426 #define wxFgets fgets
427 #define wxFopen fopen
428 #define wxFputc fputc
429 #define wxFputchar fputchar
430 #define wxFprintf fprintf
431 #define wxFreopen freopen
432 #define wxFscanf fscanf
434 #define wxGetchar getchar
436 #define wxPerror perror
437 #define wxPrintf printf
439 #define wxPutchar putchar
441 #define wxRemove remove
442 #define wxRename rename
443 #define wxScanf scanf
444 #define wxSprintf sprintf
445 #define wxSscanf sscanf
446 #define wxTmpnam tmpnam
447 #define wxUngetc ungetc
448 #define wxVfprint vfprintf
449 #define wxVprintf vprintf
450 #define wxVsscanf vsscanf
451 #define wxVsprintf vsprintf
452 #undef wxNEED_WX_STDIO_H
455 #ifdef wxNEED_WX_STDLIB_H
459 #define wxGetenv getenv
460 #define wxSystem system
461 #undef wxNEED_WX_STDLIB_H
464 #ifdef wxNEED_WX_TIME_H
465 #define wxAsctime asctime
466 #define wxCtime ctime
467 #define wxStrftime strftime
468 #undef wxNEED_WX_TIME_H
472 #if defined(wxNEED_WCSLEN) && wxUSE_UNICODE
473 #define wcslen wxStrlen
477 /// checks whether the passed in pointer is NULL and if the string is empty
478 WXDLLEXPORT
inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
480 #ifndef wxNEED_WX_STRING_H
481 /// safe version of strlen() (returns 0 if passed NULL pointer)
482 WXDLLEXPORT
inline size_t wxStrlen(const wxChar
*psz
)
483 { return psz
? wxStrlen_(psz
) : 0; }
487 // multibyte<->widechar conversion
488 WXDLLEXPORT
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
489 WXDLLEXPORT
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
491 #define wxMB2WX wxMB2WC
492 #define wxWX2MB wxWC2MB
493 #define wxWC2WX wxStrncpy
494 #define wxWX2WC wxStrncpy
496 #define wxMB2WX wxStrncpy
497 #define wxWX2MB wxStrncpy
498 #define wxWC2WX wxWC2MB
499 #define wxWX2WC wxMB2WC
502 // No wxUSE_WCHAR_T: we have to do something (JACS)
503 #define wxMB2WC wxStrncpy
504 #define wxWC2MB wxStrncpy
505 #define wxMB2WX wxStrncpy
506 #define wxWX2MB wxStrncpy
507 #define wxWC2WX wxWC2MB
508 #define wxWX2WC wxMB2WC
511 WXDLLEXPORT
bool wxOKlibc(); // for internal use
513 // if libc versions are not available, use replacements defined in wxchar.cpp
515 WXDLLEXPORT wxChar
* wxStrdup(const wxChar
*psz
);
519 WXDLLEXPORT
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
523 WXDLLEXPORT wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
527 WXDLLEXPORT wxChar
* wxSetlocale(int category
, const wxChar
*locale
);
530 #ifdef wxNEED_WCSLEN // for use in buffer.h
531 WXDLLEXPORT
size_t wcslen(const wchar_t *s
);
534 #ifdef wxNEED_WX_CTYPE_H
535 WXDLLEXPORT
int wxIsalnum(wxChar ch
);
536 WXDLLEXPORT
int wxIsalpha(wxChar ch
);
537 WXDLLEXPORT
int wxIsctrl(wxChar ch
);
538 WXDLLEXPORT
int wxIsdigit(wxChar ch
);
539 WXDLLEXPORT
int wxIsgraph(wxChar ch
);
540 WXDLLEXPORT
int wxIslower(wxChar ch
);
541 WXDLLEXPORT
int wxIsprint(wxChar ch
);
542 WXDLLEXPORT
int wxIspunct(wxChar ch
);
543 WXDLLEXPORT
int wxIsspace(wxChar ch
);
544 WXDLLEXPORT
int wxIsupper(wxChar ch
);
545 WXDLLEXPORT
int wxIsxdigit(wxChar ch
);
546 WXDLLEXPORT
int wxTolower(wxChar ch
);
547 WXDLLEXPORT
int wxToupper(wxChar ch
);
550 #ifdef wxNEED_WX_STRING_H
551 WXDLLEXPORT wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
552 WXDLLEXPORT wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
553 WXDLLEXPORT
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
554 WXDLLEXPORT
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
555 WXDLLEXPORT wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
556 WXDLLEXPORT
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
557 WXDLLEXPORT
size_t wxStrlen(const wxChar
*s
);
558 WXDLLEXPORT wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
559 WXDLLEXPORT
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
560 WXDLLEXPORT wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
561 WXDLLEXPORT wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
562 WXDLLEXPORT wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
563 WXDLLEXPORT
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
564 WXDLLEXPORT wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
565 WXDLLEXPORT
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
566 WXDLLEXPORT
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
567 WXDLLEXPORT
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
568 WXDLLEXPORT
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
571 #ifdef wxNEED_WX_STDIO_H
574 WXDLLEXPORT
int wxPrintf(const wxChar
*fmt
, ...);
575 WXDLLEXPORT
int wxVprintf(const wxChar
*fmt
, va_list argptr
);
576 WXDLLEXPORT
int wxFprintf(FILE *stream
, const wxChar
*fmt
, ...);
577 WXDLLEXPORT
int wxVfprintf(FILE *stream
, const wxChar
*fmt
, va_list argptr
);
578 WXDLLEXPORT
int wxSprintf(wxChar
*buf
, const wxChar
*fmt
, ...);
579 WXDLLEXPORT
int wxVsprintf(wxChar
*buf
, const wxChar
*fmt
, va_list argptr
);
580 WXDLLEXPORT
int wxSscanf(const wxChar
*buf
, const wxChar
*fmt
, ...);
581 WXDLLEXPORT
int wxVsscanf(const wxChar
*buf
, const wxChar
*fmt
, va_list argptr
);
585 WXDLLEXPORT
double wxAtof(const wxChar
*psz
);
588 #ifdef wxNEED_WX_STDLIB_H
589 WXDLLEXPORT
int wxAtoi(const wxChar
*psz
);
590 WXDLLEXPORT
long wxAtol(const wxChar
*psz
);
591 WXDLLEXPORT wxChar
* wxGetenv(const wxChar
*name
);
592 WXDLLEXPORT
int wxSystem(const wxChar
*psz
);