]> git.saurik.com Git - wxWidgets.git/blob - include/wx/wxchar.h
Late note about deprecated wxDbTable constructor.
[wxWidgets.git] / include / wx / wxchar.h
1 /*
2 * Name: wx/wxchar.h
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
6 * Created: 1998/06/12
7 * RCS-ID: $Id$
8 * Copyright: (c) 1998-2002 wxWidgets dev team
9 * Licence: wxWindows licence
10 */
11
12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
13
14 #ifndef _WX_WXCHAR_H_
15 #define _WX_WXCHAR_H_
16
17 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
18 #pragma interface "wxchar.h"
19 #endif
20
21 #include "wx/defs.h" /* for wxUSE_UNICODE */
22
23 /* check whether we have wchar_t and which size it is if we do */
24 #if !defined(wxUSE_WCHAR_T)
25 #if defined(__UNIX__)
26 #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || defined(__DARWIN__)
27 #define wxUSE_WCHAR_T 1
28 #else
29 #define wxUSE_WCHAR_T 0
30 #endif
31 #elif defined(__GNUWIN32__) && !defined(__MINGW32__)
32 #define wxUSE_WCHAR_T 0
33 #elif defined(__WATCOMC__)
34 #define wxUSE_WCHAR_T 0
35 #elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
36 #define wxUSE_WCHAR_T 0
37 #else
38 /* add additional compiler checks if this fails */
39 #define wxUSE_WCHAR_T 1
40 #endif
41 #endif /* !defined(wxUSE_WCHAR_T) */
42
43 /* Unicode support requires wchar_t */
44 #if wxUSE_UNICODE && !wxUSE_WCHAR_T
45 #error "wchar_t must be available in Unicode build"
46 #endif /* Unicode */
47
48 /*
49 Standard headers we need here.
50
51 NB: don't include any wxWidgets headers here because almost of them include
52 this one!
53 */
54
55 /* Required for wxPrintf() etc */
56 #include <stdarg.h>
57
58 /* Almost all compiler have strdup(), but not quite all: CodeWarrior under Mac */
59 /* and VC++ for Windows CE don't provide it */
60 #if !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
61 /* use #define, not inline wrapper, as it is tested with #ifndef below */
62 #define wxStrdupA strdup
63 #endif
64
65 /*
66 non Unix compilers which do have wchar.h (but not tchar.h which is included
67 below and which includes wchar.h anyhow).
68
69 Actually MinGW has tchar.h, but it does not include wchar.h
70 */
71 #if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__) || defined(__WATCOMC__)
72 #ifndef HAVE_WCHAR_H
73 #define HAVE_WCHAR_H
74 #endif
75 #endif
76 #if defined(__MWERKS__) && !defined(__MACH__)
77 #ifndef HAVE_WCSLEN
78 #define HAVE_WCSLEN
79 #endif
80 #endif
81
82 #if wxUSE_WCHAR_T
83 #ifdef HAVE_WCHAR_H
84 /* the current (as of Nov 2002) version of cygwin has a bug in its */
85 /* wchar.h -- there is no extern "C" around the declarations in it and */
86 /* this results in linking errors later; also, at least on some */
87 /* Cygwin versions, wchar.h requires sys/types.h */
88 #ifdef __CYGWIN__
89 #include <sys/types.h>
90 extern "C" {
91 #endif /* Cygwin */
92 #include <wchar.h>
93 #ifdef __CYGWIN__
94 }
95 #endif /* Cygwin */
96 #elif defined(HAVE_WCSTR_H)
97 /* old compilers have relevant declarations here */
98 #include <wcstr.h>
99 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
100 /* include stdlib.h for wchar_t */
101 #include <stdlib.h>
102 #endif /* HAVE_WCHAR_H */
103 #endif /* wxUSE_WCHAR_T */
104
105 /* ---------------------------------------------------------------------------- */
106 /* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
107 /* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
108 /* the function mapping _tfoo() -> foo() or wfoo() */
109 /* ---------------------------------------------------------------------------- */
110
111 /* VC++ and BC++ starting with 5.2 have TCHAR support */
112 #ifdef __VISUALC__
113 #define wxHAVE_TCHAR_SUPPORT
114 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
115 #define wxHAVE_TCHAR_SUPPORT
116 #include <ctype.h>
117 #elif defined(__WATCOMC__)
118 #define wxHAVE_TCHAR_SUPPORT
119 #elif defined(__DMC__)
120 #define wxHAVE_TCHAR_SUPPORT
121 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 )
122 #define wxHAVE_TCHAR_SUPPORT
123 #include <stddef.h>
124 #include <string.h>
125 #include <ctype.h>
126 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
127 /* VZ: the old VisualAge definitions were completely wrong and had no */
128 /* chance at all to work in Unicode build anyhow so let's pretend that */
129 /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
130 /* "0 &&" above) until someone really has time to delve into Unicode */
131 /* issues under OS/2 */
132
133 /* VisualAge 4.0+ supports TCHAR */
134 #define wxHAVE_TCHAR_SUPPORT
135 #endif /* compilers with (good) TCHAR support */
136
137 #ifdef __MWERKS__
138 #define HAVE_WPRINTF
139 #endif
140
141 #ifdef wxHAVE_TCHAR_SUPPORT
142 /* get TCHAR definition if we've got it */
143 #include <tchar.h>
144
145 /* we surely do have wchar_t if we have TCHAR */
146 #ifndef wxUSE_WCHAR_T
147 #define wxUSE_WCHAR_T 1
148 #endif /* !defined(wxUSE_WCHAR_T) */
149
150 /* and we also do have wcslen() */
151 #ifndef HAVE_WCSLEN
152 #define HAVE_WCSLEN
153 #endif
154 #endif /* wxHAVE_TCHAR_SUPPORT */
155
156 /* ---------------------------------------------------------------------------- */
157 /* define wxChar type */
158 /* ---------------------------------------------------------------------------- */
159
160 /* TODO: define wxCharInt to be equal to either int or wint_t? */
161
162 #if !wxUSE_UNICODE
163 typedef char wxChar;
164 typedef signed char wxSChar;
165 typedef unsigned char wxUChar;
166 #else /* Unicode */
167 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
168 /* signed/unsigned version of it which (a) makes sense to me (unlike */
169 /* char wchar_t is always unsigned) and (b) was how the previous */
170 /* definitions worked so keep it like this */
171
172 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
173 /* comment below */
174 #if !defined(__WCHAR_TYPE__) || \
175 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
176 /* standard case */
177 typedef wchar_t wxChar;
178 typedef wchar_t wxSChar;
179 typedef wchar_t wxUChar;
180 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
181 /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
182 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
183 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
184 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
185 /* have to define wxChar conditionally depending on detected */
186 /* compiler & compiler version. */
187 /* with old definition of wxChar. */
188 typedef __WCHAR_TYPE__ wxChar;
189 typedef __WCHAR_TYPE__ wxSChar;
190 typedef __WCHAR_TYPE__ wxUChar;
191 #endif /* __WCHAR_TYPE__ */
192 #endif /* ASCII/Unicode */
193
194 /* ---------------------------------------------------------------------------- */
195 /* define _T() and related macros */
196 /* ---------------------------------------------------------------------------- */
197
198 /* BSD systems define _T() to be something different in ctype.h, override it */
199 #if defined(__FreeBSD__) || defined(__DARWIN__)
200 #include <ctype.h>
201 #undef _T
202 #endif
203
204 /* could already be defined by tchar.h (it's quasi standard) */
205 #ifndef _T
206 #if !wxUSE_UNICODE
207 #define _T(x) x
208 #else /* Unicode */
209 #define _T(x) L ## x
210 #endif /* ASCII/Unicode */
211 #endif /* !defined(_T) */
212
213 /* although global macros with such names are normally bad, we want to have */
214 /* another name for _T() which should be used to avoid confusion between _T() */
215 /* and _() in wxWidgets sources */
216 #define wxT(x) _T(x)
217
218 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
219 #ifndef __TFILE__
220 #define __XFILE__(x) wxT(x)
221 #define __TFILE__ __XFILE__(__FILE__)
222 #endif
223
224 #ifndef __TDATE__
225 #define __XDATE__(x) wxT(x)
226 #define __TDATE__ __XDATE__(__DATE__)
227 #endif
228
229 #ifndef __TTIME__
230 #define __XTIME__(x) wxT(x)
231 #define __TTIME__ __XTIME__(__TIME__)
232 #endif
233
234 /*
235 define wxFoo() function for each standard foo() function whose signature
236 (exceptionally including the return type) includes any mention of char:
237 wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
238 the same signature but with char replaced by wxChar which allows us to use
239 it in Unicode build as well
240 */
241
242 #ifdef wxHAVE_TCHAR_SUPPORT
243 #include <ctype.h>
244
245 /* ctype.h functions */
246 #define wxIsalnum _istalnum
247 #define wxIsalpha _istalpha
248 #define wxIscntrl _istcntrl
249 #define wxIsdigit _istdigit
250 #define wxIsgraph _istgraph
251 #define wxIslower _istlower
252 #define wxIsprint _istprint
253 #define wxIspunct _istpunct
254 #define wxIsspace _istspace
255 #define wxIsupper _istupper
256 #define wxIsxdigit _istxdigit
257
258 /*
259 There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
260 signed chars < 0, so "fix" it here.
261 */
262 #define wxTolower(c) _totlower((wxUChar)(c))
263 #define wxToupper(c) _totupper((wxUChar)(c))
264
265 /* locale.h functons */
266 #define wxSetlocale _tsetlocale
267
268 /* string.h functions */
269 #define wxStrcat _tcscat
270 #define wxStrchr _tcschr
271 #define wxStrcmp _tcscmp
272 #define wxStrcoll _tcscoll
273 #define wxStrcpy _tcscpy
274 #define wxStrcspn _tcscspn
275 #define wxStrdupW _wcsdup /* notice the 'W'! */
276 #define wxStrftime _tcsftime
277 #define wxStricmp _tcsicmp
278 #define wxStrnicmp _tcsnicmp
279 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
280 #define wxStrncat _tcsncat
281 #define wxStrncmp _tcsncmp
282 #define wxStrncpy _tcsncpy
283 #define wxStrpbrk _tcspbrk
284 #define wxStrrchr _tcsrchr
285 #define wxStrspn _tcsspn
286 #define wxStrstr _tcsstr
287 #define wxStrtod _tcstod
288 #define wxStrtol _tcstol
289 #define wxStrtoul _tcstoul
290 #define wxStrxfrm _tcsxfrm
291
292 /* stdio.h functions */
293 #define wxFgetc _fgettc
294 #define wxFgetchar _fgettchar
295 #define wxFgets _fgetts
296 #define wxFopen _tfopen
297 #define wxFputc _fputtc
298 #define wxFputchar _fputtchar
299 #define wxFprintf _ftprintf
300 #define wxFputs _fputts
301 #define wxFreopen _tfreopen
302 #define wxFscanf _ftscanf
303 #define wxGetc _gettc
304 #define wxGetchar _gettchar
305 #define wxGets _getts
306 #define wxPerror _tperror
307 #define wxPrintf _tprintf
308 #define wxPutc _puttc
309 #define wxPutchar _puttchar
310 #define wxPuts _putts
311 #define wxScanf _tscanf
312 #if defined(__DMC__)
313 #if wxUSE_UNICODE
314 /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
315 int wxSprintf (wchar_t * __RESTRICT s, const wchar_t * __RESTRICT format, ... ) ;
316 #else
317 /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
318 #define wxSprintf sprintf
319 #endif
320 #else
321 #define wxSprintf _stprintf
322 #endif
323
324 #define wxSscanf _stscanf
325 #define wxTmpnam _ttmpnam
326 #define wxUngetc _tungetc
327 #define wxVfprintf _vftprintf
328 #define wxVprintf _vtprintf
329 #define wxVsscanf _vstscanf
330 #define wxVsprintf _vstprintf
331
332 /* special case: not all TCHAR-aware compilers have those */
333 #if defined(__VISUALC__) || \
334 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
335 #define wxVsnprintf_ _vsntprintf
336 #define wxSnprintf_ _sntprintf
337 #endif
338
339 /* special case: these functions are missing under Win9x with Unicows so we */
340 /* have to implement them ourselves */
341 #if wxUSE_UNICODE_MSLU
342 #define wxRemove wxMSLU__tremove
343 #define wxRename wxMSLU__trename
344 #else
345 #ifdef __WXWINCE__
346 #define wxRemove DeleteFile
347 #else
348 #define wxRemove _tremove
349 #define wxRename _trename
350 #endif
351 #endif
352
353 /* stdlib.h functions */
354 #define wxAtoi _ttoi
355 #define wxAtol _ttol
356 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
357 #define wxGetenv _tgetenv
358 #define wxSystem _tsystem
359
360 /* time.h functions */
361 #define wxAsctime _tasctime
362 #define wxCtime _tctime
363 #else /* !TCHAR-aware compilers */
364
365 /* No UNICODE in the c library except wchar_t typedef on mac OSX 10.2 and less - roll our own */
366 #if wxUSE_UNICODE && __DARWIN__ && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 ) && !defined(__MWERKS__)
367
368 /* we need everything! */
369 #define wxNEED_WX_STRING_H
370 #define wxNEED_WX_CTYPE_H
371
372 #define wxFgetchar(c) wxFgetc(c, stdin)
373 #define wxFputc wxPutc
374 #define wxFputchar(c) wxPutc(c, stdout)
375 #define wxGetc wxFgetc
376 #define wxGetchar(c) wxFgetc(c, stdin)
377
378 #include <stdio.h>
379
380 #define wxNEED_FGETC
381 #define wxNEED_FGETS
382 #define wxNEED_GETS
383 #define wxNEED_UNGETC
384
385 #define wxNEED_FPUTS
386 #define wxNEED_PUTC
387
388 int wxFputs(const wxChar *ch, FILE *stream);
389 int wxPutc(wxChar ch, FILE *stream);
390
391 WXDLLIMPEXP_BASE size_t wxStrlen_(const wxChar *s);
392
393 #define wxPutchar(wch) wxPutc(wch, stdout)
394 #define wxPuts(ws) wxFputs(ws, stdout)
395
396 #define wxNEED_PRINTF_CONVERSION
397 #define wxNEED_WX_STDIO_H
398 #define wxNEED_WX_STDLIB_H
399 #define wxNEED_WX_TIME_H
400
401 /* even though they are defined and "implemented", they are bad and just
402 stubs so we need our own */
403 #define mbstowcs wxInternalMbstowcs
404 #define wcstombs wxInternalWcstombs
405
406 WXDLLIMPEXP_BASE size_t wxInternalMbstowcs (wchar_t *, const char *, size_t);
407 WXDLLIMPEXP_BASE size_t wxInternalWcstombs (char *, const wchar_t *, size_t);
408
409 #elif wxUSE_UNICODE
410 #include <wctype.h>
411
412 /* this is probably glibc-specific */
413 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
414 /* ctype.h functions (wctype.h) */
415 #define wxIsalnum iswalnum
416 #define wxIsalpha iswalpha
417 #define wxIscntrl iswcntrl
418 #define wxIsdigit iswdigit
419 #define wxIsgraph iswgraph
420 #define wxIslower iswlower
421 #define wxIsprint iswprint
422 #define wxIspunct iswpunct
423 #define wxIsspace iswspace
424 #define wxIsupper iswupper
425 #define wxIsxdigit iswxdigit
426
427 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
428 /* /usr/include/wctype.h incorrectly declares translations */
429 /* tables which provokes tons of compile-time warnings -- try */
430 /* to correct this */
431 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
432 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
433 #else /* !glibc 2.0 */
434 #define wxTolower towlower
435 #define wxToupper towupper
436 #endif /* gcc/!gcc */
437
438 /* string.h functions (wchar.h) */
439 #define wxStrcat wcscat
440 #define wxStrchr wcschr
441 #define wxStrcmp wcscmp
442 #define wxStrcoll wcscoll
443 #define wxStrcpy wcscpy
444 #define wxStrcspn wcscspn
445 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
446 #define wxStrncat wcsncat
447 #define wxStrncmp wcsncmp
448 #define wxStrncpy wcsncpy
449 #define wxStrpbrk wcspbrk
450 #define wxStrrchr wcsrchr
451 #define wxStrspn wcsspn
452 #define wxStrstr wcsstr
453 #define wxStrtod wcstod
454 #define wxStrtol wcstol
455 #define wxStrtoul wcstoul
456 #define wxStrxfrm wcsxfrm
457
458 #define wxFgetc fgetwc
459 #define wxFgetchar fgetwchar
460 #define wxFgets fgetws
461 #define wxFputc fputwc
462 #define wxFputchar fputwchar
463 #define wxGetc getwc
464 #define wxGetchar getwchar
465 #define wxGets getws
466 #define wxUngetc ungetwc
467
468 #ifdef HAVE_FPUTWS
469 #define wxFputs fputws
470 #else
471 #define wxNEED_FPUTS
472 #include <stdio.h>
473 int wxFputs(const wxChar *ch, FILE *stream);
474 #endif
475
476 #ifdef HAVE_WPUTC
477 #define wxPutc wputc
478 #else
479 #define wxNEED_PUTC
480 #include <stdio.h>
481 int wxPutc(wxChar ch, FILE *stream);
482 #endif
483
484 #ifdef HAVE_WPUTCHAR
485 #define wxPutchar wputchar
486 #else
487 #define wxPutchar(wch) wxPutc(wch, stdout)
488 #endif
489
490 #ifdef HAVE_PUTWS
491 #define wxPuts putws
492 #else
493 #define wxPuts(ws) wxFputs(ws, stdout)
494 #endif
495
496 /* we need %s to %ls conversion for printf and scanf etc */
497 #define wxNEED_PRINTF_CONVERSION
498
499 /* glibc doesn't have wide char equivalents of the other stuff so */
500 /* use our own versions */
501 #define wxNEED_WX_STDIO_H
502 #define wxNEED_WX_STDLIB_H
503 #define wxNEED_WX_TIME_H
504 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
505 /* ctype.h functions (wctype.h) */
506 #define wxIsalnum iswalnum
507 #define wxIsalpha iswalpha
508 #define wxIscntrl iswcntrl
509 #define wxIsdigit iswdigit
510 #define wxIsgraph iswgraph
511 #define wxIslower iswlower
512 #define wxIsprint iswprint
513 #define wxIspunct iswpunct
514 #define wxIsspace iswspace
515 #define wxIsupper iswupper
516 #define wxIsxdigit iswxdigit
517 #define wxTolower towlower
518 #define wxToupper towupper
519
520 /* string.h functions (wchar.h) */
521 #define wxStrcat wcscat
522 #define wxStrchr wcschr
523 #define wxStrcmp wcscmp
524 #define wxStrcoll wcscoll
525 #define wxStrcpy wcscpy
526 #define wxStrcspn wcscspn
527 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
528 #define wxStrncat wcsncat
529 #define wxStrncmp wcsncmp
530 #define wxStrncpy wcsncpy
531 #define wxStrpbrk wcspbrk
532 #define wxStrrchr wcsrchr
533 #define wxStrspn wcsspn
534 #define wxStrstr wcsstr
535 #define wxStrtod wcstod
536 #define wxStrtol wcstol
537 #define wxStrtoul wcstoul
538 #define wxStrxfrm wcsxfrm
539
540 #define wxFgetc fgetwc
541 #define wxFgetchar fgetwchar
542 #define wxFgets fgetws
543 #define wxFputc fputwc
544 #define wxFputchar fputwchar
545 #define wxGetc getwc
546 #define wxGetchar getwchar
547 #define wxGets getws
548 #define wxUngetc ungetwc
549
550 #define wxNEED_PRINTF_CONVERSION
551
552 #define wxPutc putwc
553 #define wxPutchar putwchar
554 #define wxFputs fputws
555
556 /* stdio.h functions */
557
558 #define wxNEED_WX_STDIO_H
559
560 /* stdlib.h functions */
561 #ifdef __MACH__
562 #define wxNEED_WX_STDLIB_H
563 #else
564 #define wxAtof watof
565 #define wxAtoi watoi
566 #define wxAtol watol
567 #define wxGetenv(a) ((wxChar*)NULL)
568 #define wxSystem(a) ((int)NULL)
569 #endif
570 /* time.h functions */
571 #define wxAsctime wasciitime
572 #define wxCtime wctime
573 /* #define wxStrftime wcsftime */
574
575 #define wxNEED_WX_TIME_H
576 #else /* !metrowerks for apple */
577 #error "Please define wide character functions for your environment"
578 #endif
579 #else /* ASCII */
580 #include <ctype.h>
581 #include <string.h>
582
583 /* ctype.h functions */
584 #define wxIsalnum isalnum
585 #define wxIsalpha isalpha
586 #define wxIscntrl iscntrl
587 #define wxIsdigit isdigit
588 #define wxIsgraph isgraph
589 #define wxIslower islower
590 #define wxIsprint isprint
591 #define wxIspunct ispunct
592 #define wxIsspace isspace
593 #define wxIsupper isupper
594 #define wxIsxdigit isxdigit
595 #define wxTolower tolower
596 #define wxToupper toupper
597
598 /* locale.h functons */
599 #define wxSetlocale setlocale
600
601 /* string.h functions */
602 #define wxStrcat strcat
603 #define wxStrchr strchr
604 #define wxStrcmp strcmp
605 #define wxStrcoll strcoll
606 #define wxStrcpy strcpy
607 #define wxStrcspn strcspn
608
609 /* wxStricmp and wxStrnicmp are defined below */
610 #define wxStrlen_ strlen /* used in wxStrlen inline function */
611 #define wxStrncat strncat
612 #define wxStrncmp strncmp
613 #define wxStrncpy strncpy
614 #define wxStrpbrk strpbrk
615 #define wxStrrchr strrchr
616 #define wxStrspn strspn
617 #define wxStrstr strstr
618 #define wxStrtod strtod
619 #ifdef HAVE_STRTOK_R
620 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
621 #endif
622 #define wxStrtol strtol
623 #define wxStrtoul strtoul
624 #define wxStrxfrm strxfrm
625
626 /* stdio.h functions */
627 #define wxFopen fopen
628 #define wxFreopen freopen
629 #define wxRemove remove
630 #define wxRename rename
631
632 #define wxPerror perror
633 #define wxTmpnam tmpnam
634
635 #define wxFgetc fgetc
636 #define wxFgetchar fgetchar
637 #define wxFgets fgets
638 #define wxFputc fputc
639 #define wxFputs fputs
640 #define wxFputchar fputchar
641 #define wxFprintf fprintf
642 #define wxFscanf fscanf
643 #define wxGetc getc
644 #define wxGetchar getchar
645 #define wxGets gets
646 #define wxPrintf printf
647 #define wxPutc putc
648 #define wxPutchar putchar
649 #define wxPuts puts
650 #define wxScanf scanf
651 #define wxSprintf sprintf
652 #define wxSscanf sscanf
653 #define wxUngetc ungetc
654 #define wxVfprintf vfprintf
655 #define wxVprintf vprintf
656 #define wxVsscanf vsscanf
657 #define wxVsprintf vsprintf
658
659 /* stdlib.h functions */
660 #define wxAtof atof
661 #define wxAtoi atoi
662 #define wxAtol atol
663 #define wxGetenv getenv
664 #define wxSystem system
665
666 /* time.h functions */
667 #define wxAsctime asctime
668 #define wxCtime ctime
669 #define wxStrftime strftime
670 #endif /* Unicode/ASCII */
671 #endif /* TCHAR-aware compilers/the others */
672
673 /*
674 various special cases
675 */
676
677 /* define wxStricmp and wxStrnicmp for various compilers */
678
679 /* note that in Unicode mode we definitely are going to need our own version */
680 #if !defined(wxStricmp) && !wxUSE_UNICODE
681 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
682 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
683 defined(__EMX__) || defined(__DJGPP__)
684 #define wxStricmp stricmp
685 #define wxStrnicmp strnicmp
686 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
687 (defined(__MWERKS__) && defined(__INTEL__))
688 #define wxStricmp _stricmp
689 #define wxStrnicmp _strnicmp
690 #elif defined(__UNIX__) || defined(__GNUWIN32__)
691 #define wxStricmp strcasecmp
692 #define wxStrnicmp strncasecmp
693 /* #else -- use wxWidgets implementation */
694 #endif
695 #endif /* !defined(wxStricmp) */
696
697 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
698 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
699 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
700 #if wxUSE_WCHAR_T
701 #ifdef HAVE_WCSLEN
702 #define wxWcslen wcslen
703 #else
704 #if defined( __WXMAC_XCODE__ ) && !defined( __cplusplus )
705 /* xcode native targets are giving multiply defined symbols on regex */
706 static
707 #endif
708 inline size_t wxWcslen(const wchar_t *s)
709 {
710 size_t n = 0;
711 while ( *s++ )
712 n++;
713
714 return n;
715 }
716 #endif
717 #endif /* wxUSE_WCHAR_T */
718
719 #ifdef __cplusplus
720 /* checks whether the passed in pointer is NULL and if the string is empty */
721 inline bool wxIsEmpty(const wxChar *p) { return !p || !*p; }
722
723 /* safe version of strlen() (returns 0 if passed NULL pointer) */
724 inline size_t wxStrlen(const wxChar *psz) { return psz ? wxStrlen_(psz) : 0; }
725 #endif
726
727 /*
728 each of strdup() and wcsdup() may or may not be available but we need both
729 of them anyhow for wx/buffer.h so we define the missing one(s) in
730 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
731 defined -- if this is somehow not the case in some situations, please
732 correct that and not the lines here
733 */
734 #if wxUSE_UNICODE
735 #define wxStrdup wxStrdupW
736 #else
737 #define wxStrdup wxStrdupA
738 #endif
739
740 #ifdef __cplusplus
741 WXDLLIMPEXP_BASE bool wxOKlibc(); /* for internal use */
742 #endif
743
744 /* printf() family saga */
745
746 /*
747 For some systems vsnprintf() exists in the system libraries but not in the
748 headers, so we need to declare it ourselves to be able to use it.
749 */
750 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
751 extern "C"
752 int vsnprintf(char *str, size_t size, const char *format, va_list ap);
753 #endif /* !HAVE_VSNPRINTF_DECL */
754
755 /*
756 First of all, we always want to define safe snprintf() function to be used
757 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
758 which we really need...), otherwise we implement it using our own printf()
759 code.
760
761 We define function with a trailing underscore here because the real one is a
762 wrapper around it as explained below
763 */
764 #ifndef wxVsnprintf_
765 #if wxUSE_UNICODE
766 #if defined(__MWERKS__)
767 #define HAVE_WCSRTOMBS 1
768 #define HAVE_VSWPRINTF 1
769 #endif
770 #if defined(__WATCOMC__)
771 #define wxVsnprintf_ _vsnwprintf
772 #define wxSnprintf_ _snwprintf
773 #endif
774 #if defined(HAVE__VSNWPRINTF)
775 #define wxVsnprintf_ _vsnwprintf
776 /* MinGW?MSVCRT has the wrong vswprintf */
777 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
778 #define wxVsnprintf_ vswprintf
779 #endif
780 #else /* ASCII */
781 /* all versions of CodeWarrior supported by wxWidgets apparently have */
782 /* vsnprintf() */
783 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
784 /* assume we have snprintf() too if we have vsnprintf() */
785 #define wxVsnprintf_ vsnprintf
786 #define wxSnprintf_ snprintf
787 #endif
788 #endif
789 #endif /* wxVsnprintf_ not defined yet */
790
791 #ifndef wxSnprintf_
792 /* no [v]snprintf(), cook our own */
793 WXDLLIMPEXP_BASE int wxSnprintf_(wxChar *buf, size_t len, const wxChar *format,
794 ...) ATTRIBUTE_PRINTF_3;
795 #endif
796 #ifndef wxVsnprintf_
797 WXDLLIMPEXP_BASE int wxVsnprintf_(wxChar *buf, size_t len, const wxChar *format,
798 va_list argptr);
799 #endif
800
801 /*
802 In Unicode mode we need to have all standard functions such as wprintf() and
803 so on but not all systems have them so use our own implementations in this
804 case.
805 */
806 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
807 #define wxNEED_WPRINTF
808 #endif
809
810 /*
811 More Unicode complications: although both ANSI C and C++ define a number of
812 wide character functions such as wprintf(), not all environments have them.
813 Worse, those which do have different behaviours: under Windows, %s format
814 specifier changes its meaning in Unicode build and expects a Unicode string
815 while under Unix/POSIX it still means an ASCII string even for wprintf() and
816 %ls has to be used for wide strings.
817
818 We choose to always emulate Windows behaviour as more useful for us so even
819 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
820
821 */
822
823 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
824 /*
825 we need to implement all wide character printf and scanf functions
826 either because we don't have them at all or because they don't have the
827 semantics we need
828 */
829
830 #include <stdio.h> /* for FILE */
831
832 int wxScanf( const wxChar *format, ... ) ATTRIBUTE_PRINTF_1;
833 int wxSscanf( const wxChar *str, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
834 int wxFscanf( FILE *stream, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
835 int wxVsscanf( const wxChar *str, const wxChar *format, va_list ap );
836 int wxPrintf( const wxChar *format, ... ) ATTRIBUTE_PRINTF_1;
837 int wxSprintf( wxChar *str, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
838 int wxFprintf( FILE *stream, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
839 int wxVfprintf( FILE *stream, const wxChar *format, va_list ap );
840 int wxVprintf( const wxChar *format, va_list ap );
841 int wxVsprintf( wxChar *str, const wxChar *format, va_list ap );
842 #endif /* wxNEED_PRINTF_CONVERSION */
843
844 /* these 2 can be simply mapped to the versions with underscore at the end */
845 /* if we don't have to do the conversion */
846 /*
847 However, if we don't have any vswprintf() at all we don't need to redefine
848 anything as our own wxVsnprintf_() already behaves as needed.
849 */
850 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
851 int wxSnprintf( wxChar *str, size_t size, const wxChar *format, ... ) ATTRIBUTE_PRINTF_3;
852 int wxVsnprintf( wxChar *str, size_t size, const wxChar *format, va_list ap );
853 #else
854 #define wxSnprintf wxSnprintf_
855 #define wxVsnprintf wxVsnprintf_
856 #endif
857
858 /*
859 various functions which might not be available in libc and for which we
860 provide our own replacements in wxchar.cpp
861 */
862
863 /* ctype.h functions */
864
865 /* RN: Used only under OSX <= 10.2 currently */
866 #ifdef wxNEED_WX_CTYPE_H
867 WXDLLIMPEXP_BASE int wxIsalnum(wxChar ch);
868 WXDLLIMPEXP_BASE int wxIsalpha(wxChar ch);
869 WXDLLIMPEXP_BASE int wxIscntrl(wxChar ch);
870 WXDLLIMPEXP_BASE int wxIsdigit(wxChar ch);
871 WXDLLIMPEXP_BASE int wxIsgraph(wxChar ch);
872 WXDLLIMPEXP_BASE int wxIslower(wxChar ch);
873 WXDLLIMPEXP_BASE int wxIsprint(wxChar ch);
874 WXDLLIMPEXP_BASE int wxIspunct(wxChar ch);
875 WXDLLIMPEXP_BASE int wxIsspace(wxChar ch);
876 WXDLLIMPEXP_BASE int wxIsupper(wxChar ch);
877 WXDLLIMPEXP_BASE int wxIsxdigit(wxChar ch);
878 WXDLLIMPEXP_BASE int wxTolower(wxChar ch);
879 WXDLLIMPEXP_BASE int wxToupper(wxChar ch);
880 #endif /* wxNEED_WX_CTYPE_H */
881
882 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
883 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
884 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
885 #undef wxIsspace
886 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
887 #endif /* VC++ */
888
889 /*
890 a few compilers don't have the (non standard but common) isascii function,
891 define it ourselves for them
892 */
893 #ifndef isascii
894 #if defined(__MWERKS__)
895 #define wxNEED_ISASCII
896 #elif defined(_WIN32_WCE)
897 #if _WIN32_WCE <= 211
898 #define wxNEED_ISASCII
899 #endif
900 #endif
901 #endif /* isascii */
902
903 #ifdef wxNEED_ISASCII
904 inline int isascii(int c) { return (unsigned)c < 0x80; }
905 #endif
906
907 #ifdef _WIN32_WCE
908 #if _WIN32_WCE <= 211
909 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
910 #endif
911 #endif /* _WIN32_WCE */
912
913 /*
914 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
915 initial versions of this header -- now it is too late to remove it so
916 although we fixed the function/macro name above, still provide the
917 backwards-compatible synonym.
918 */
919 #define wxIsctrl wxIscntrl
920
921 /* string.h functions */
922 #ifndef strdup
923 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
924 #define wxNEED_STRDUP
925 #elif defined(__WXWINCE__)
926 #if _WIN32_WCE <= 211
927 #define wxNEED_STRDUP
928 #endif
929 #endif
930 #endif /* strdup */
931
932 #ifdef wxNEED_STRDUP
933 WXDLLIMPEXP_BASE char *strdup(const char* s);
934 #endif
935
936 /* RN: Used only under OSX <= 10.2 currently */
937 #ifdef wxNEED_WX_STRING_H
938 WXDLLIMPEXP_BASE wxChar * wxStrcat(wxChar *dest, const wxChar *src);
939 WXDLLIMPEXP_BASE const wxChar * wxStrchr(const wxChar *s, wxChar c);
940 inline wxChar * wxStrchr(wxChar *s, wxChar c)
941 { return (wxChar *)wxStrchr((const wxChar *)s, c); }
942 WXDLLIMPEXP_BASE int wxStrcmp(const wxChar *s1, const wxChar *s2);
943 WXDLLIMPEXP_BASE int wxStrcoll(const wxChar *s1, const wxChar *s2);
944 WXDLLIMPEXP_BASE wxChar * wxStrcpy(wxChar *dest, const wxChar *src);
945 WXDLLIMPEXP_BASE size_t wxStrcspn(const wxChar *s, const wxChar *reject);
946 WXDLLIMPEXP_BASE wxChar * wxStrncat(wxChar *dest, const wxChar *src, size_t n);
947 WXDLLIMPEXP_BASE int wxStrncmp(const wxChar *s1, const wxChar *s2, size_t n);
948 WXDLLIMPEXP_BASE wxChar * wxStrncpy(wxChar *dest, const wxChar *src, size_t n);
949 WXDLLIMPEXP_BASE const wxChar * wxStrpbrk(const wxChar *s, const wxChar *accept);
950 inline wxChar * wxStrpbrk(wxChar *s, const wxChar *accept)
951 { return (wxChar *)wxStrpbrk((const wxChar *)s, accept); }
952 WXDLLIMPEXP_BASE const wxChar * wxStrrchr(const wxChar *s, wxChar c);
953 inline wxChar * wxStrrchr(wxChar *s, wxChar c)
954 { return (wxChar *)wxStrrchr((const wxChar *)s, c); }
955 WXDLLIMPEXP_BASE size_t wxStrspn(const wxChar *s, const wxChar *accept);
956 WXDLLIMPEXP_BASE const wxChar * wxStrstr(const wxChar *haystack, const wxChar *needle);
957 inline wxChar *wxStrstr(wxChar *haystack, const wxChar *needle)
958 { return (wxChar *)wxStrstr((const wxChar *)haystack, needle); }
959 WXDLLIMPEXP_BASE double wxStrtod(const wxChar *nptr, wxChar **endptr);
960 WXDLLIMPEXP_BASE long int wxStrtol(const wxChar *nptr, wxChar **endptr, int base);
961 WXDLLIMPEXP_BASE unsigned long int wxStrtoul(const wxChar *nptr, wxChar **endptr, int base);
962 WXDLLIMPEXP_BASE size_t wxStrxfrm(wxChar *dest, const wxChar *src, size_t n);
963 #endif /* wxNEED_WX_STRING_H */
964
965 #ifndef wxStrdupA
966 WXDLLIMPEXP_BASE char *wxStrdupA(const char *psz);
967 #endif
968
969 #ifndef wxStrdupW
970 WXDLLIMPEXP_BASE wchar_t *wxStrdupW(const wchar_t *pwz);
971 #endif
972
973 #ifndef wxStricmp
974 WXDLLIMPEXP_BASE int wxStricmp(const wxChar *psz1, const wxChar *psz2);
975 #endif
976
977 #ifndef wxStrnicmp
978 WXDLLIMPEXP_BASE int wxStrnicmp(const wxChar *psz1, const wxChar *psz2, size_t len);
979 #endif
980
981 #ifndef wxStrtok
982 WXDLLIMPEXP_BASE wxChar * wxStrtok(wxChar *psz, const wxChar *delim, wxChar **save_ptr);
983 #endif
984
985 #ifdef __cplusplus
986 #ifndef wxSetlocale
987 class WXDLLIMPEXP_BASE wxWCharBuffer;
988 WXDLLIMPEXP_BASE wxWCharBuffer wxSetlocale(int category, const wxChar *locale);
989 #endif
990 #endif
991
992 /* stdio.h functions */
993 #ifdef wxNEED_WX_STDIO_H
994 #include <stdio.h>
995 WXDLLIMPEXP_BASE FILE * wxFopen(const wxChar *path, const wxChar *mode);
996 WXDLLIMPEXP_BASE FILE * wxFreopen(const wxChar *path, const wxChar *mode, FILE *stream);
997 WXDLLIMPEXP_BASE int wxRemove(const wxChar *path);
998 WXDLLIMPEXP_BASE int wxRename(const wxChar *oldpath, const wxChar *newpath);
999
1000 /* *printf() family is handled separately */
1001 #endif /* wxNEED_WX_STDIO_H */
1002
1003
1004 /* stdlib.h functions */
1005 #ifndef wxAtof
1006 WXDLLIMPEXP_BASE double wxAtof(const wxChar *psz);
1007 #endif
1008
1009 #ifdef wxNEED_WX_STDLIB_H
1010 WXDLLIMPEXP_BASE int wxAtoi(const wxChar *psz);
1011 WXDLLIMPEXP_BASE long wxAtol(const wxChar *psz);
1012 WXDLLIMPEXP_BASE wxChar * wxGetenv(const wxChar *name);
1013 WXDLLIMPEXP_BASE int wxSystem(const wxChar *psz);
1014 #endif
1015
1016
1017 /* time.h functions */
1018 #ifdef wxNEED_WX_TIME_H
1019 #if defined(__MWERKS__) && defined(macintosh)
1020 #include <time.h>
1021 #endif
1022 WXDLLIMPEXP_BASE size_t wxStrftime(wxChar *s, size_t max,
1023 const wxChar *fmt, const struct tm *tm);
1024 #endif /* wxNEED_WX_TIME_H */
1025
1026 #ifndef wxCtime
1027 #include <time.h>
1028 WXDLLIMPEXP_BASE wxChar *wxCtime(const time_t *timep);
1029 #endif
1030
1031
1032 /* missing functions in some WinCE versions */
1033 #ifdef _WIN32_WCE
1034 #if (_WIN32_WCE < 300)
1035 WXDLLIMPEXP_BASE void *calloc( size_t num, size_t size );
1036 #endif
1037 #endif /* _WIN32_WCE */
1038
1039 /* multibyte to wide char conversion functions and macros */
1040
1041 #if wxUSE_WCHAR_T
1042 /* multibyte<->widechar conversion */
1043 WXDLLIMPEXP_BASE size_t wxMB2WC(wchar_t *buf, const char *psz, size_t n);
1044 WXDLLIMPEXP_BASE size_t wxWC2MB(char *buf, const wchar_t *psz, size_t n);
1045
1046 #if wxUSE_UNICODE
1047 #define wxMB2WX wxMB2WC
1048 #define wxWX2MB wxWC2MB
1049 #define wxWC2WX wxStrncpy
1050 #define wxWX2WC wxStrncpy
1051 #else
1052 #define wxMB2WX wxStrncpy
1053 #define wxWX2MB wxStrncpy
1054 #define wxWC2WX wxWC2MB
1055 #define wxWX2WC wxMB2WC
1056 #endif
1057 #else /* !wxUSE_UNICODE */
1058 #error ha
1059 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1060 #define wxMB2WC wxStrncpy
1061 #define wxWC2MB wxStrncpy
1062 #define wxMB2WX wxStrncpy
1063 #define wxWX2MB wxStrncpy
1064 #define wxWC2WX wxWC2MB
1065 #define wxWX2WC wxMB2WC
1066 #endif
1067
1068 //
1069 // RN: The following are not normal versions of memcpy et al., rather
1070 // these are either char or widechar versions depending on
1071 // if unicode is used or not.
1072 //
1073
1074 #ifdef __cplusplus
1075
1076 //
1077 // RN: We could do the usual tricky compiler detection here,
1078 // and use their variant (such as wmemchr, etc.). The problem
1079 // is that these functions are quite rare, even though they are
1080 // part of the current POSIX standard. In addition, most compilers
1081 // (including even MSC) inline them just like we do right in their
1082 // headers.
1083 //
1084 #if wxUSE_UNICODE
1085 #include <string.h> //for mem funcs
1086
1087 //implement our own wmem variants
1088 inline wxChar* wxMemchr(const wxChar* s, wxChar c, size_t l)
1089 {
1090 for(;l && *s != c;--l, ++s) {}
1091
1092 if(l)
1093 return (wxChar*)s;
1094 return NULL;
1095 }
1096
1097 inline int wxMemcmp(const wxChar* sz1, const wxChar* sz2, size_t len)
1098 {
1099 for(; *sz1 == *sz2 && len; --len, ++sz1, ++sz2) {}
1100
1101 if(len)
1102 return *sz1 < *sz2 ? -1 : *sz1 > *sz2;
1103 else
1104 return 0;
1105 }
1106
1107 inline wxChar* wxMemcpy(wxChar* szOut, const wxChar* szIn, size_t len)
1108 {
1109 return (wxChar*) memcpy(szOut, szIn, len * sizeof(wxChar));
1110 }
1111
1112 inline wxChar* wxMemmove(wxChar* szOut, const wxChar* szIn, size_t len)
1113 {
1114 return (wxChar*) memmove(szOut, szIn, len * sizeof(wxChar));
1115 }
1116
1117 inline wxChar* wxMemset(wxChar* szOut, const wxChar cIn, size_t len)
1118 {
1119 wxChar* szRet = szOut;
1120
1121 while (len--)
1122 *szOut++ = cIn;
1123
1124 return szRet;
1125 }
1126
1127 #else //!wxUSE_UNICODE
1128 # define wxMemchr memchr
1129 # define wxMemcmp memcmp
1130 # define wxMemcpy memcpy
1131 # define wxMemmove memmove
1132 # define wxMemset memset
1133 #endif
1134
1135 #endif /*__cplusplus*/
1136
1137
1138 #endif /* _WX_WXCHAR_H_ */
1139