]> git.saurik.com Git - wxWidgets.git/blame_incremental - include/wx/wxchar.h
projects / wxWidgets.git / blame_incremental
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (non-incremental) | history | HEAD
Added calendar contributed by Lorne White
[wxWidgets.git] / include / wx / wxchar.h
... / ...
CommitLineData
1/////////////////////////////////////////////////////////////////////////////
2// Name: wxchar.h
3// Purpose: Declarations common to wx char/wchar_t usage (wide chars)
4// Author: Joel Farley
5// Modified by:
6// Created: 1998/06/12
7// RCS-ID: $Id$
8// Copyright: (c) wxWindows copyright
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_WXCHAR_H_
13#define _WX_WXCHAR_H_
14
15//#ifdef __GNUG__
16//#pragma interface "wxchar.h"
17//#endif
18
19// only do SBCS or _UNICODE
20#if defined (_MBCS )
21# error "MBCS is not supported by wxChar"
22#endif
23
24// set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined
25#if defined(_UNICODE) || defined(UNICODE)
26# undef wxUSE_UNICODE
27# define wxUSE_UNICODE 1
28#else
29# ifndef wxUSE_UNICODE
30# define wxUSE_UNICODE 0
31# endif
32#endif
33
34// and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1...
35#if wxUSE_UNICODE
36# ifndef _UNICODE
37# define _UNICODE
38# endif
39# ifndef UNICODE
40# define UNICODE
41# endif
42#endif
43
44// Windows (VC++) has broad TCHAR support
45#if defined(__VISUALC__) && defined(__WIN32__)
46
47# define HAVE_WCSLEN 1
48
49# include <tchar.h>
50
51# if wxUSE_UNICODE // temporary - preserve binary compatibility
52typedef _TCHAR wxChar;
53typedef _TSCHAR wxSChar;
54typedef _TUCHAR wxUChar;
55# else
56# define wxChar char
57# define wxSChar signed char
58# define wxUChar unsigned char
59# endif
60 // wchar_t is available
61# undef wxUSE_WCHAR_T
62# define wxUSE_WCHAR_T 1
63
64 // ctype.h functions
65# define wxIsalnum _istalnum
66# define wxIsalpha _istalpha
67# define wxIsctrl _istctrl
68# define wxIsdigit _istdigit
69# define wxIsgraph _istgraph
70# define wxIslower _istlower
71# define wxIsprint _istprint
72# define wxIspunct _istpunct
73# define wxIsspace _istspace
74# define wxIsupper _istupper
75# define wxIsxdigit _istxdigit
76# define wxTolower _totlower
77# define wxToupper _totupper
78
79 // locale.h functons
80# define wxSetlocale _tsetlocale
81
82 // string.h functions
83# define wxStrcat _tcscat
84# define wxStrchr _tcschr
85# define wxStrcmp _tcscmp
86# define wxStrcoll _tcscoll
87# define wxStrcpy _tcscpy
88# define wxStrcspn _tcscspn
89# define wxStrftime _tcsftime
90# define wxStricmp _tcsicmp
91# define wxStrlen_ _tcslen // used in wxStrlen inline function
92# define wxStrncat _tcsncat
93# define wxStrncmp _tcsncmp
94# define wxStrncpy _tcsncpy
95# define wxStrpbrk _tcspbrk
96# define wxStrrchr _tcsrchr
97# define wxStrspn _tcsspn
98# define wxStrstr _tcsstr
99# define wxStrtod _tcstod
100// is there a _tcstok[_r] ?
101# define wxStrtol _tcstol
102# define wxStrtoul _tcstoul
103# define wxStrxfrm _tcsxfrm
104
105 // stdio.h functions
106# define wxFgetc _fgettc
107# define wxFgetchar _fgettchar
108# define wxFgets _fgetts
109# define wxFopen _tfopen
110# define wxFputc _fputtc
111# define wxFputchar _fputtchar
112# define wxFprintf _ftprintf
113# define wxFreopen _tfreopen
114# define wxFscanf _ftscanf
115# define wxGetc _gettc
116# define wxGetchar _gettchar
117# define wxGets _getts
118# define wxPerror _tperror
119# define wxPrintf _tprintf
120# define wxPutc _puttc
121# define wxPutchar _puttchar
122# define wxPuts _putts
123# define wxRemove _tremove
124# define wxRename _trename
125# define wxScanf _tscanf
126# define wxSprintf _stprintf
127# define wxSscanf _stscanf
128# define wxTmpnam _ttmpnam
129# define wxUngetc _tungetc
130# define wxVfprint _vftprintf
131# define wxVprintf _vtprintf
132# define wxVsscanf _vstscanf
133# define wxVsprintf _vstprintf
134
135 // stdlib.h functions
136# if !wxUSE_UNICODE
137# define wxAtof atof
138# endif
139# define wxAtoi _ttoi
140# define wxAtol _ttol
141# define wxGetenv _tgetenv
142# define wxSystem _tsystem
143
144 // time.h functions
145# define wxAsctime _tasctime
146# define wxCtime _tctime
147
148// #elif defined(XXX)
149 // #include XXX-specific files here
150 // typeddef YYY wxChar;
151
152 // translate wxZZZ names
153
154#elif defined(__BORLANDC__) && defined(__WIN32__)
155
156// Borland C++ 4.52 doesn't have much tchar support
157// maybe Borland C++ 5.02 has, can't check right now
158// but I'll use the Win32 API instead here
159
160# include <tchar.h>
161# if wxUSE_UNICODE // temporary - preserve binary compatibility
162typedef _TCHAR wxChar;
163typedef _TSCHAR wxSChar;
164typedef _TUCHAR wxUChar;
165# else
166# define wxChar char
167# define wxSChar signed char
168# define wxUChar unsigned char
169# endif
170 // wchar_t is available
171# undef wxUSE_WCHAR_T
172# define wxUSE_WCHAR_T 1
173
174# define wxNEED_WX_CTYPE_H
175// #define wxStrtok strtok_r // Borland C++ 4.52 doesn't have strtok_r
176# define wxNEED_WX_STRING_H
177# define wxNEED_WX_STDIO_H
178# define wxNEED_WX_STDLIB_H
179# define wxNEED_WX_TIME_H
180# define wxNEED_WCSLEN
181
182#else//!TCHAR-aware compilers
183
184// check whether we should include wchar.h or equivalent
185# if wxUSE_UNICODE
186# undef wxUSE_WCHAR_T
187# define wxUSE_WCHAR_T 1 // wchar_t *must* be available in Unicode mode
188# elif !defined(wxUSE_WCHAR_T)
189# if defined(__VISUALC__) && (__VISUALC__ < 900)
190# define wxUSE_WCHAR_T 0 // wchar_t is not available for MSVC++ 1.5
191# elif defined(__UNIX__)
192# if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__)
193# define wxUSE_WCHAR_T 1
194# else
195# define wxUSE_WCHAR_T 0
196# endif
197# elif defined(__GNUWIN32__) && !defined(__MINGW32__) // Cygwin (not Mingw32) doesn't have wcslen.h, needed in buffer.h
198# define wxUSE_WCHAR_T 0
199# elif defined(__BORLANDC__) // WIN16 BC++
200# define wxUSE_WCHAR_T 0
201# elif defined(__WATCOMC__)
202# define wxUSE_WCHAR_T 0
203# else
204 // add additional compiler checks if this fails
205# define wxUSE_WCHAR_T 1
206# endif
207# endif//wxUSE_UNICODE
208
209# if wxUSE_WCHAR_T
210# ifdef HAVE_WCSTR_H
211# include <wcstr.h>
212# else
213# ifndef __FreeBSD__
214# include <wchar.h>
215# else
216# include <stdlib.h>
217# define wxNEED_WCSLEN
218# endif
219# endif
220# endif
221
222// check whether we are doing Unicode
223# if wxUSE_UNICODE
224
225# include <wctype.h>
226
227// this is probably glibc-specific
228# if defined(__WCHAR_TYPE__)
229
230typedef __WCHAR_TYPE__ wxChar;
231typedef signed __WCHAR_TYPE__ wxSChar;
232typedef unsigned __WCHAR_TYPE__ wxUChar;
233
234# define _T(x) L##x
235
236 // ctype.h functions (wctype.h)
237# define wxIsalnum iswalnum
238# define wxIsalpha iswalpha
239# define wxIsctrl iswcntrl
240# define wxIsdigit iswdigit
241# define wxIsgraph iswgraph
242# define wxIslower iswlower
243# define wxIsprint iswprint
244# define wxIspunct iswpunct
245# define wxIsspace iswspace
246# define wxIsupper iswupper
247# define wxIsxdigit iswxdigit
248
249# if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
250 // /usr/include/wctype.h incorrectly declares translations tables which
251 // provokes tons of compile-time warnings - try to correct this
252# define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
253# define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
254# else
255# define wxTolower towlower
256# define wxToupper towupper
257# endif // gcc/!gcc
258
259 // string.h functions (wchar.h)
260# define wxStrcat wcscat
261# define wxStrchr wcschr
262# define wxStrcmp wcscmp
263# define wxStrcoll wcscoll
264# define wxStrcpy wcscpy
265# define wxStrcspn wcscspn
266# define wxStrlen_ wcslen // used in wxStrlen inline function
267# define wxStrncat wcsncat
268# define wxStrncmp wcsncmp
269# define wxStrncpy wcsncpy
270# define wxStrpbrk wcspbrk
271# define wxStrrchr wcsrchr
272# define wxStrspn wcsspn
273# define wxStrstr wcsstr
274# define wxStrtod wcstod
275# define wxStrtok wcstok
276# define wxStrtol wcstol
277# define wxStrtoul wcstoul
278# define wxStrxfrm wcsxfrm
279
280// glibc doesn't have wc equivalents of the other stuff
281# define wxNEED_WX_STDIO_H
282# define wxNEED_WX_STDLIB_H
283# define wxNEED_WX_TIME_H
284
285# else//!glibc
286# error "Please define your compiler's Unicode conventions in wxChar.h"
287# endif
288# else//!Unicode
289
290# include <ctype.h>
291# include <string.h>
292
293# if 0 // temporary - preserve binary compatibilty
294 typedef char wxChar;
295 typedef signed char wxSChar;
296 typedef unsigned char wxUChar;
297# else
298# define wxChar char
299# define wxSChar signed char
300# define wxUChar unsigned char
301# endif
302
303# ifdef __FreeBSD__
304# undef _T
305# endif
306
307# if !defined(__MINGW32__) || !defined(_T)
308# define _T(x) x
309# endif
310
311 // ctype.h functions
312# define wxIsalnum isalnum
313# define wxIsalpha isalpha
314# define wxIsctrl isctrl
315# define wxIsdigit isdigit
316# define wxIsgraph isgraph
317# define wxIslower islower
318# define wxIsprint isprint
319# define wxIspunct ispunct
320# define wxIsspace isspace
321# define wxIsupper isupper
322# define wxIsxdigit isxdigit
323# define wxTolower tolower
324# define wxToupper toupper
325
326 // locale.h functons
327# define wxSetlocale setlocale
328
329 // string.h functions
330 // #define wxStricmp strcasecmp
331 // wxStricmp is defined below!!
332
333 #ifdef HAVE_STRTOK_R
334 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
335 #else
336 #define wxStrtok(str, sep, last) strtok(str, sep)
337 #endif
338
339 // leave the rest to defaults below
340# define wxNEED_WX_STRING_H
341# define wxNEED_WX_STDIO_H
342# define wxNEED_WX_STDLIB_H
343# define wxNEED_WX_TIME_H
344
345# endif//Unicode
346#endif//TCHAR-aware compilers
347
348// define wxStricmp for various compilers without Unicode possibilities
349#if !defined(wxStricmp) && !wxUSE_UNICODE
350# if defined(__BORLANDC__) || defined(__WATCOMC__) || defined(__SALFORDC__) || defined(__VISAGECPP__) || defined(__EMX__)
351# define wxStricmp stricmp
352# define wxStrnicmp strnicmp
353# elif defined(__SC__) || defined(__VISUALC__) || (defined(__MWERKS__) && defined(__INTEL__))
354# define wxStricmp _stricmp
355# define wxStrnicmp _strnicmp
356# elif defined(__UNIX__) || defined(__GNUWIN32__)
357# define wxStricmp strcasecmp
358# define wxStrnicmp strncasecmp
359# elif defined(__MWERKS__) && !defined(__INTEL__)
360 // use wxWindows' implementation
361# else
362 // if you leave wxStricmp undefined, wxWindows' implementation will be used
363# error "Please define string case-insensitive compare for your OS/compiler"
364# endif
365#endif
366
367// if we need to define for standard headers, and we're not using Unicode,
368// just define to standard C library routines
369#if !wxUSE_UNICODE
370# ifdef wxNEED_WX_STRING_H
371# define wxStrcat strcat
372# define wxStrchr strchr
373# define wxStrcmp strcmp
374# define wxStrcoll strcoll
375# define wxStrcpy strcpy
376# define wxStrcspn strcspn
377# define wxStrdup strdup
378# define wxStrlen_ strlen // used in wxStrlen inline function
379# define wxStrncat strncat
380# define wxStrncmp strncmp
381# define wxStrncpy strncpy
382# define wxStrpbrk strpbrk
383# define wxStrrchr strrchr
384# define wxStrspn strspn
385# define wxStrstr strstr
386# define wxStrtod strtod
387# define wxStrtol strtol
388# define wxStrtoul strtoul
389# define wxStrxfrm strxfrm
390# undef wxNEED_WX_STRING_H
391# endif
392
393# ifdef wxNEED_WX_STDIO_H
394# define wxFgetc fgetc
395# define wxFgetchar fgetchar
396# define wxFgets fgets
397# define wxFopen fopen
398# define wxFputc fputc
399# define wxFputchar fputchar
400# define wxFprintf fprintf
401# define wxFreopen freopen
402# define wxFscanf fscanf
403# define wxGetc getc
404# define wxGetchar getchar
405# define wxGets gets
406# define wxPerror perror
407# define wxPrintf printf
408# define wxPutc putc
409# define wxPutchar putchar
410# define wxPuts puts
411# define wxRemove remove
412# define wxRename rename
413# define wxScanf scanf
414# define wxSprintf sprintf
415# define wxSscanf sscanf
416# define wxTmpnam tmpnam
417# define wxUngetc ungetc
418# define wxVfprint vfprintf
419# define wxVprintf vprintf
420# define wxVsscanf vsscanf
421# define wxVsprintf vsprintf
422# undef wxNEED_WX_STDIO_H
423# endif
424
425# ifdef wxNEED_WX_STDLIB_H
426# define wxAtof atof
427# define wxAtoi atoi
428# define wxAtol atol
429# define wxGetenv getenv
430# define wxSystem system
431# undef wxNEED_WX_STDLIB_H
432# endif
433
434# ifdef wxNEED_WX_TIME_H
435# define wxAsctime asctime
436# define wxCtime ctime
437# define wxStrftime strftime
438# undef wxNEED_WX_TIME_H
439# endif
440#endif //!Unicode
441
442#if defined(wxNEED_WCSLEN) && wxUSE_UNICODE
443# define wcslen wxStrlen
444# undef wxNEED_WCSLEN
445#endif
446
447/// checks whether the passed in pointer is NULL and if the string is empty
448WXDLLEXPORT inline bool wxIsEmpty(const wxChar *p) { return !p || !*p; }
449
450#ifndef wxNEED_WX_STRING_H
451/// safe version of strlen() (returns 0 if passed NULL pointer)
452WXDLLEXPORT inline size_t wxStrlen(const wxChar *psz)
453 { return psz ? wxStrlen_(psz) : 0; }
454#endif
455
456#if wxUSE_WCHAR_T
457// multibyte<->widechar conversion
458WXDLLEXPORT size_t wxMB2WC(wchar_t *buf, const char *psz, size_t n);
459WXDLLEXPORT size_t wxWC2MB(char *buf, const wchar_t *psz, size_t n);
460# if wxUSE_UNICODE
461# define wxMB2WX wxMB2WC
462# define wxWX2MB wxWC2MB
463# define wxWC2WX wxStrncpy
464# define wxWX2WC wxStrncpy
465# else
466# define wxMB2WX wxStrncpy
467# define wxWX2MB wxStrncpy
468# define wxWC2WX wxWC2MB
469# define wxWX2WC wxMB2WC
470# endif
471#else
472// No wxUSE_WCHAR_T: we have to do something (JACS)
473# define wxMB2WC wxStrncpy
474# define wxWC2MB wxStrncpy
475# define wxMB2WX wxStrncpy
476# define wxWX2MB wxStrncpy
477# define wxWC2WX wxWC2MB
478# define wxWX2WC wxMB2WC
479#endif
480
481WXDLLEXPORT bool wxOKlibc(); // for internal use
482
483// if libc versions are not available, use replacements defined in wxchar.cpp
484#ifndef wxStrdup
485WXDLLEXPORT wxChar * wxStrdup(const wxChar *psz);
486#endif
487
488#ifndef wxStricmp
489WXDLLEXPORT int wxStricmp(const wxChar *psz1, const wxChar *psz2);
490#endif
491
492#ifndef wxStrtok
493WXDLLEXPORT wxChar * wxStrtok(wxChar *psz, const wxChar *delim, wxChar **save_ptr);
494#endif
495
496#ifndef wxSetlocale
497WXDLLEXPORT wxChar * wxSetlocale(int category, const wxChar *locale);
498#endif
499
500#ifdef wxNEED_WCSLEN // for use in buffer.h
501WXDLLEXPORT size_t wcslen(const wchar_t *s);
502#endif
503
504#ifdef wxNEED_WX_CTYPE_H
505WXDLLEXPORT int wxIsalnum(wxChar ch);
506WXDLLEXPORT int wxIsalpha(wxChar ch);
507WXDLLEXPORT int wxIsctrl(wxChar ch);
508WXDLLEXPORT int wxIsdigit(wxChar ch);
509WXDLLEXPORT int wxIsgraph(wxChar ch);
510WXDLLEXPORT int wxIslower(wxChar ch);
511WXDLLEXPORT int wxIsprint(wxChar ch);
512WXDLLEXPORT int wxIspunct(wxChar ch);
513WXDLLEXPORT int wxIsspace(wxChar ch);
514WXDLLEXPORT int wxIsupper(wxChar ch);
515WXDLLEXPORT int wxIsxdigit(wxChar ch);
516WXDLLEXPORT int wxTolower(wxChar ch);
517WXDLLEXPORT int wxToupper(wxChar ch);
518#endif
519
520#ifdef wxNEED_WX_STRING_H
521WXDLLEXPORT wxChar * wxStrcat(wxChar *dest, const wxChar *src);
522WXDLLEXPORT wxChar * wxStrchr(const wxChar *s, wxChar c);
523WXDLLEXPORT int wxStrcmp(const wxChar *s1, const wxChar *s2);
524WXDLLEXPORT int wxStrcoll(const wxChar *s1, const wxChar *s2);
525WXDLLEXPORT wxChar * wxStrcpy(wxChar *dest, const wxChar *src);
526WXDLLEXPORT size_t wxStrcspn(const wxChar *s, const wxChar *reject);
527WXDLLEXPORT size_t wxStrlen(const wxChar *s);
528WXDLLEXPORT wxChar * wxStrncat(wxChar *dest, const wxChar *src, size_t n);
529WXDLLEXPORT int wxStrncmp(const wxChar *s1, const wxChar *s2, size_t n);
530WXDLLEXPORT wxChar * wxStrncpy(wxChar *dest, const wxChar *src, size_t n);
531WXDLLEXPORT wxChar * wxStrpbrk(const wxChar *s, const wxChar *accept);
532WXDLLEXPORT wxChar * wxStrrchr(const wxChar *s, wxChar c);
533WXDLLEXPORT size_t wxStrspn(const wxChar *s, const wxChar *accept);
534WXDLLEXPORT wxChar * wxStrstr(const wxChar *haystack, const wxChar *needle);
535WXDLLEXPORT double wxStrtod(const wxChar *nptr, wxChar **endptr);
536WXDLLEXPORT long int wxStrtol(const wxChar *nptr, wxChar **endptr, int base);
537WXDLLEXPORT unsigned long int wxStrtoul(const wxChar *nptr, wxChar **endptr, int base);
538WXDLLEXPORT size_t wxStrxfrm(wxChar *dest, const wxChar *src, size_t n);
539#endif
540
541#ifdef wxNEED_WX_STDIO_H
542# include <stdio.h>
543# include <stdarg.h>
544WXDLLEXPORT FILE * wxFopen(const wxChar *path, const wxChar *mode);
545WXDLLEXPORT FILE * wxFreopen(const wxChar *path, const wxChar *mode, FILE *stream);
546WXDLLEXPORT int wxPrintf(const wxChar *fmt, ...);
547WXDLLEXPORT int wxVprintf(const wxChar *fmt, va_list argptr);
548WXDLLEXPORT int wxFprintf(FILE *stream, const wxChar *fmt, ...);
549WXDLLEXPORT int wxVfprintf(FILE *stream, const wxChar *fmt, va_list argptr);
550WXDLLEXPORT int wxSprintf(wxChar *buf, const wxChar *fmt, ...);
551WXDLLEXPORT int wxVsprintf(wxChar *buf, const wxChar *fmt, va_list argptr);
552WXDLLEXPORT int wxSscanf(const wxChar *buf, const wxChar *fmt, ...);
553WXDLLEXPORT int wxVsscanf(const wxChar *buf, const wxChar *fmt, va_list argptr);
554#endif
555
556#ifndef wxAtof
557WXDLLEXPORT double wxAtof(const wxChar *psz);
558#endif
559
560#ifdef wxNEED_WX_STDLIB_H
561WXDLLEXPORT int wxAtoi(const wxChar *psz);
562WXDLLEXPORT long wxAtol(const wxChar *psz);
563WXDLLEXPORT wxChar * wxGetenv(const wxChar *name);
564WXDLLEXPORT int wxSystem(const wxChar *psz);
565#endif
566
567#ifdef wxNEED_WX_TIME_H
568WXDLLEXPORT size_t wxStrftime(wxChar *s, size_t max, const wxChar *fmt, const struct tm *tm);
569#endif
570
571// although global macros with such names are really bad, we want to have
572// another name for _T() which should be used to avoid confusion between _T()
573// and _() in wxWindows sources
574#define wxT(x) _T(x)
575
576// a Unicode-friendly __FILE__ analog
577#ifndef __TFILE__
578 #define __XFILE__(x) wxT(x)
579 #define __TFILE__ __XFILE__(__FILE__)
580#endif
581
582#endif
583 //_WX_WXCHAR_H_
584
wxWidgets (Impactor)