]>
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
29 # ifndef wxUSE_UNICODE
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__)
47 # define HAVE_WCSLEN 1
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
138 # define wxAtoi _ttoi
139 # define wxAtol _ttol
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
170 # undef wxUSE_WCHAR_T
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
185 # undef wxUSE_WCHAR_T
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
327 // wxStricmp is defined below!!
329 // #define wxStrtok strtok_r // this needs a configure check
331 // leave the rest to defaults below
332 # define wxNEED_WX_STRING_H
333 # define wxNEED_WX_STDIO_H
334 # define wxNEED_WX_STDLIB_H
335 # define wxNEED_WX_TIME_H
338 #endif//TCHAR-aware compilers
340 // define wxStricmp for various compilers without Unicode possibilities
341 #if !defined(wxStricmp) && !wxUSE_UNICODE
342 # if defined(__BORLANDC__) || defined(__WATCOMC__) || defined(__SALFORDC__) || defined(__VISAGECPP__) || defined(__EMX__)
343 # define wxStricmp stricmp
344 # elif defined(__SC__) || defined(__VISUALC__) || (defined(__MWERKS) && defined(__INTEL__))
345 # define wxStricmp _stricmp
346 # elif defined(__UNIX__) || defined(__GNUWIN32__)
347 # define wxStricmp strcasecmp
348 # elif defined(__MWERKS__) && !defined(__INTEL__)
349 // use wxWindows' implementation
351 // if you leave wxStricmp undefined, wxWindows' implementation will be used
352 # error "Please define string case-insensitive compare for your OS/compiler"
356 // if we need to define for standard headers, and we're not using Unicode,
357 // just define to standard C library routines
359 # ifdef wxNEED_WX_STRING_H
360 # define wxStrcat strcat
361 # define wxStrchr strchr
362 # define wxStrcmp strcmp
363 # define wxStrcoll strcoll
364 # define wxStrcpy strcpy
365 # define wxStrcspn strcspn
366 # define wxStrdup strdup
367 # define wxStrlen_ strlen // used in wxStrlen inline function
368 # define wxStrncat strncat
369 # define wxStrncmp strncmp
370 # define wxStrncpy strncpy
371 # define wxStrpbrk strpbrk
372 # define wxStrrchr strrchr
373 # define wxStrspn strspn
374 # define wxStrstr strstr
375 # define wxStrtod strtod
376 # define wxStrtol strtol
377 # define wxStrtoul strtoul
378 # define wxStrxfrm strxfrm
379 # undef wxNEED_WX_STRING_H
382 # ifdef wxNEED_WX_STDIO_H
383 # define wxFgetc fgetc
384 # define wxFgetchar fgetchar
385 # define wxFgets fgets
386 # define wxFopen fopen
387 # define wxFputc fputc
388 # define wxFputchar fputchar
389 # define wxFprintf fprintf
390 # define wxFreopen freopen
391 # define wxFscanf fscanf
393 # define wxGetchar getchar
395 # define wxPerror perror
396 # define wxPrintf printf
398 # define wxPutchar putchar
400 # define wxRemove remove
401 # define wxRename rename
402 # define wxScanf scanf
403 # define wxSprintf sprintf
404 # define wxSscanf sscanf
405 # define wxTmpnam tmpnam
406 # define wxUngetc ungetc
407 # define wxVfprint vfprintf
408 # define wxVprintf vprintf
409 # define wxVsscanf vsscanf
410 # define wxVsprintf vsprintf
411 # undef wxNEED_WX_STDIO_H
414 # ifdef wxNEED_WX_STDLIB_H
418 # define wxGetenv getenv
419 # define wxSystem system
420 # undef wxNEED_WX_STDLIB_H
423 # ifdef wxNEED_WX_TIME_H
424 # define wxAsctime asctime
425 # define wxCtime ctime
426 # define wxStrftime strftime
427 # undef wxNEED_WX_TIME_H
431 #if defined(wxNEED_WCSLEN) && wxUSE_UNICODE
432 # define wcslen wxStrlen
433 # undef wxNEED_WCSLEN
436 /// checks whether the passed in pointer is NULL and if the string is empty
437 WXDLLEXPORT
inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
439 #ifndef wxNEED_WX_STRING_H
440 /// safe version of strlen() (returns 0 if passed NULL pointer)
441 WXDLLEXPORT
inline size_t wxStrlen(const wxChar
*psz
)
442 { return psz
? wxStrlen_(psz
) : 0; }
446 // multibyte<->widechar conversion
447 WXDLLEXPORT
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
448 WXDLLEXPORT
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
450 # define wxMB2WX wxMB2WC
451 # define wxWX2MB wxWC2MB
452 # define wxWC2WX wxStrncpy
453 # define wxWX2WC wxStrncpy
455 # define wxMB2WX wxStrncpy
456 # define wxWX2MB wxStrncpy
457 # define wxWC2WX wxWC2MB
458 # define wxWX2WC wxMB2WC
461 // No wxUSE_WCHAR_T: we have to do something (JACS)
462 # define wxMB2WC wxStrncpy
463 # define wxWC2MB wxStrncpy
464 # define wxMB2WX wxStrncpy
465 # define wxWX2MB wxStrncpy
466 # define wxWC2WX wxWC2MB
467 # define wxWX2WC wxMB2WC
470 WXDLLEXPORT
bool wxOKlibc(); // for internal use
472 // if libc versions are not available, use replacements defined in wxchar.cpp
474 WXDLLEXPORT wxChar
* wxStrdup(const wxChar
*psz
);
478 WXDLLEXPORT
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
482 WXDLLEXPORT wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
486 WXDLLEXPORT wxChar
* wxSetlocale(int category
, const wxChar
*locale
);
489 #ifdef wxNEED_WCSLEN // for use in buffer.h
490 WXDLLEXPORT
size_t wcslen(const wchar_t *s
);
493 #ifdef wxNEED_WX_CTYPE_H
494 WXDLLEXPORT
int wxIsalnum(wxChar ch
);
495 WXDLLEXPORT
int wxIsalpha(wxChar ch
);
496 WXDLLEXPORT
int wxIsctrl(wxChar ch
);
497 WXDLLEXPORT
int wxIsdigit(wxChar ch
);
498 WXDLLEXPORT
int wxIsgraph(wxChar ch
);
499 WXDLLEXPORT
int wxIslower(wxChar ch
);
500 WXDLLEXPORT
int wxIsprint(wxChar ch
);
501 WXDLLEXPORT
int wxIspunct(wxChar ch
);
502 WXDLLEXPORT
int wxIsspace(wxChar ch
);
503 WXDLLEXPORT
int wxIsupper(wxChar ch
);
504 WXDLLEXPORT
int wxIsxdigit(wxChar ch
);
505 WXDLLEXPORT
int wxTolower(wxChar ch
);
506 WXDLLEXPORT
int wxToupper(wxChar ch
);
509 #ifdef wxNEED_WX_STRING_H
510 WXDLLEXPORT wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
511 WXDLLEXPORT wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
512 WXDLLEXPORT
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
513 WXDLLEXPORT
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
514 WXDLLEXPORT wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
515 WXDLLEXPORT
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
516 WXDLLEXPORT
size_t wxStrlen(const wxChar
*s
);
517 WXDLLEXPORT wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
518 WXDLLEXPORT
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
519 WXDLLEXPORT wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
520 WXDLLEXPORT wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
521 WXDLLEXPORT wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
522 WXDLLEXPORT
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
523 WXDLLEXPORT wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
524 WXDLLEXPORT
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
525 WXDLLEXPORT
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
526 WXDLLEXPORT
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
527 WXDLLEXPORT
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
530 #ifdef wxNEED_WX_STDIO_H
533 WXDLLEXPORT
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
534 WXDLLEXPORT
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
535 WXDLLEXPORT
int wxPrintf(const wxChar
*fmt
, ...);
536 WXDLLEXPORT
int wxVprintf(const wxChar
*fmt
, va_list argptr
);
537 WXDLLEXPORT
int wxFprintf(FILE *stream
, const wxChar
*fmt
, ...);
538 WXDLLEXPORT
int wxVfprintf(FILE *stream
, const wxChar
*fmt
, va_list argptr
);
539 WXDLLEXPORT
int wxSprintf(wxChar
*buf
, const wxChar
*fmt
, ...);
540 WXDLLEXPORT
int wxVsprintf(wxChar
*buf
, const wxChar
*fmt
, va_list argptr
);
541 WXDLLEXPORT
int wxSscanf(const wxChar
*buf
, const wxChar
*fmt
, ...);
542 WXDLLEXPORT
int wxVsscanf(const wxChar
*buf
, const wxChar
*fmt
, va_list argptr
);
546 WXDLLEXPORT
double wxAtof(const wxChar
*psz
);
549 #ifdef wxNEED_WX_STDLIB_H
550 WXDLLEXPORT
int wxAtoi(const wxChar
*psz
);
551 WXDLLEXPORT
long wxAtol(const wxChar
*psz
);
552 WXDLLEXPORT wxChar
* wxGetenv(const wxChar
*name
);
553 WXDLLEXPORT
int wxSystem(const wxChar
*psz
);
556 #ifdef wxNEED_WX_TIME_H
557 WXDLLEXPORT
size_t wxStrftime(wxChar
*s
, size_t max
, const wxChar
*fmt
, const struct tm
*tm
);