]> git.saurik.com Git - wxWidgets.git/blob - include/wx/wxchar.h
SetSizeHints -> DoSetSizeHints
[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 #if !defined(__MWERKS__) && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
366 /* even though they are defined and "implemented", they are bad and just
367 stubs so we need our own - we need these even in ANSI builds!! */
368 #define mbstowcs wxInternalMbstowcs
369 #define wcstombs wxInternalWcstombs
370
371 WXDLLIMPEXP_BASE size_t wxInternalMbstowcs (wchar_t *, const char *, size_t);
372 WXDLLIMPEXP_BASE size_t wxInternalWcstombs (char *, const wchar_t *, size_t);
373 #endif
374
375 /* No UNICODE in the c library except wchar_t typedef on mac OSX 10.2 and less - roll our own */
376 #if !defined(__MWERKS__) && wxUSE_UNICODE && defined(__DARWIN__) && ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
377
378 /* we need everything! */
379 #define wxNEED_WX_STRING_H
380 #define wxNEED_WX_CTYPE_H
381
382 #define wxFgetchar(c) wxFgetc(c, stdin)
383 #define wxFputc wxPutc
384 #define wxFputchar(c) wxPutc(c, stdout)
385 #define wxGetc wxFgetc
386 #define wxGetchar(c) wxFgetc(c, stdin)
387
388 #include <stdio.h>
389
390 #define wxNEED_FGETC
391 #define wxNEED_FGETS
392 #define wxNEED_GETS
393 #define wxNEED_UNGETC
394
395 #define wxNEED_FPUTS
396 #define wxNEED_PUTC
397
398 int wxFputs(const wxChar *ch, FILE *stream);
399 int wxPutc(wxChar ch, FILE *stream);
400
401 #ifdef __cplusplus
402 extern "C" {
403 #endif
404 WXDLLIMPEXP_BASE size_t wxStrlen_(const wxChar *s);
405 #ifdef __cplusplus
406 }
407 #endif
408
409 #define wxPutchar(wch) wxPutc(wch, stdout)
410 #define wxPuts(ws) wxFputs(ws, stdout)
411
412 #define wxNEED_PRINTF_CONVERSION
413 #define wxNEED_WX_STDIO_H
414 #define wxNEED_WX_STDLIB_H
415 #define wxNEED_WX_TIME_H
416
417 #elif wxUSE_UNICODE
418 #include <wctype.h>
419
420 /* this is probably glibc-specific */
421 #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
422 /* ctype.h functions (wctype.h) */
423 #define wxIsalnum iswalnum
424 #define wxIsalpha iswalpha
425 #define wxIscntrl iswcntrl
426 #define wxIsdigit iswdigit
427 #define wxIsgraph iswgraph
428 #define wxIslower iswlower
429 #define wxIsprint iswprint
430 #define wxIspunct iswpunct
431 #define wxIsspace iswspace
432 #define wxIsupper iswupper
433 #define wxIsxdigit iswxdigit
434
435 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
436 /* /usr/include/wctype.h incorrectly declares translations */
437 /* tables which provokes tons of compile-time warnings -- try */
438 /* to correct this */
439 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
440 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
441 #else /* !glibc 2.0 */
442 #define wxTolower towlower
443 #define wxToupper towupper
444 #endif /* gcc/!gcc */
445
446 /* string.h functions (wchar.h) */
447 #define wxStrcat wcscat
448 #define wxStrchr wcschr
449 #define wxStrcmp wcscmp
450 #define wxStrcoll wcscoll
451 #define wxStrcpy wcscpy
452 #define wxStrcspn wcscspn
453 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
454 #define wxStrncat wcsncat
455 #define wxStrncmp wcsncmp
456 #define wxStrncpy wcsncpy
457 #define wxStrpbrk wcspbrk
458 #define wxStrrchr wcsrchr
459 #define wxStrspn wcsspn
460 #define wxStrstr wcsstr
461 #define wxStrtod wcstod
462 #define wxStrtol wcstol
463 #define wxStrtoul wcstoul
464 #define wxStrxfrm wcsxfrm
465
466 #define wxFgetc fgetwc
467 #define wxFgetchar fgetwchar
468 #define wxFgets fgetws
469 #define wxFputc fputwc
470 #define wxFputchar fputwchar
471 #define wxGetc getwc
472 #define wxGetchar getwchar
473 #define wxGets getws
474 #define wxUngetc ungetwc
475
476 #ifdef HAVE_FPUTWS
477 #define wxFputs fputws
478 #else
479 #define wxNEED_FPUTS
480 #include <stdio.h>
481 int wxFputs(const wxChar *ch, FILE *stream);
482 #endif
483
484 #ifdef HAVE_WPUTC
485 #define wxPutc wputc
486 #else
487 #define wxNEED_PUTC
488 #include <stdio.h>
489 int wxPutc(wxChar ch, FILE *stream);
490 #endif
491
492 #ifdef HAVE_WPUTCHAR
493 #define wxPutchar wputchar
494 #else
495 #define wxPutchar(wch) wxPutc(wch, stdout)
496 #endif
497
498 #ifdef HAVE_PUTWS
499 #define wxPuts putws
500 #else
501 #define wxPuts(ws) wxFputs(ws, stdout)
502 #endif
503
504 /* we need %s to %ls conversion for printf and scanf etc */
505 #define wxNEED_PRINTF_CONVERSION
506
507 /* glibc doesn't have wide char equivalents of the other stuff so */
508 /* use our own versions */
509 #define wxNEED_WX_STDIO_H
510 #define wxNEED_WX_STDLIB_H
511 #define wxNEED_WX_TIME_H
512 #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
513 /* ctype.h functions (wctype.h) */
514 #define wxIsalnum iswalnum
515 #define wxIsalpha iswalpha
516 #define wxIscntrl iswcntrl
517 #define wxIsdigit iswdigit
518 #define wxIsgraph iswgraph
519 #define wxIslower iswlower
520 #define wxIsprint iswprint
521 #define wxIspunct iswpunct
522 #define wxIsspace iswspace
523 #define wxIsupper iswupper
524 #define wxIsxdigit iswxdigit
525 #define wxTolower towlower
526 #define wxToupper towupper
527
528 /* string.h functions (wchar.h) */
529 #define wxStrcat wcscat
530 #define wxStrchr wcschr
531 #define wxStrcmp wcscmp
532 #define wxStrcoll wcscoll
533 #define wxStrcpy wcscpy
534 #define wxStrcspn wcscspn
535 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
536 #define wxStrncat wcsncat
537 #define wxStrncmp wcsncmp
538 #define wxStrncpy wcsncpy
539 #define wxStrpbrk wcspbrk
540 #define wxStrrchr wcsrchr
541 #define wxStrspn wcsspn
542 #define wxStrstr wcsstr
543 #define wxStrtod wcstod
544 #define wxStrtol wcstol
545 #define wxStrtoul wcstoul
546 #define wxStrxfrm wcsxfrm
547
548 #define wxFgetc fgetwc
549 #define wxFgetchar fgetwchar
550 #define wxFgets fgetws
551 #define wxFputc fputwc
552 #define wxFputchar fputwchar
553 #define wxGetc getwc
554 #define wxGetchar getwchar
555 #define wxGets getws
556 #define wxUngetc ungetwc
557
558 #define wxNEED_PRINTF_CONVERSION
559
560 #define wxPutc putwc
561 #define wxPutchar putwchar
562 #define wxFputs fputws
563
564 /* stdio.h functions */
565
566 #define wxNEED_WX_STDIO_H
567
568 /* stdlib.h functions */
569 #ifdef __MACH__
570 #define wxNEED_WX_STDLIB_H
571 #else
572 #define wxAtof watof
573 #define wxAtoi watoi
574 #define wxAtol watol
575 #define wxGetenv(a) ((wxChar*)NULL)
576 #define wxSystem(a) ((int)NULL)
577 #endif
578 /* time.h functions */
579 #define wxAsctime wasciitime
580 #define wxCtime wctime
581 /* #define wxStrftime wcsftime */
582
583 #define wxNEED_WX_TIME_H
584 #else /* !metrowerks for apple */
585 #error "Please define wide character functions for your environment"
586 #endif
587 #else /* ASCII */
588 #include <ctype.h>
589 #include <string.h>
590
591 /* ctype.h functions */
592 #define wxIsalnum isalnum
593 #define wxIsalpha isalpha
594 #define wxIscntrl iscntrl
595 #define wxIsdigit isdigit
596 #define wxIsgraph isgraph
597 #define wxIslower islower
598 #define wxIsprint isprint
599 #define wxIspunct ispunct
600 #define wxIsspace isspace
601 #define wxIsupper isupper
602 #define wxIsxdigit isxdigit
603 #define wxTolower tolower
604 #define wxToupper toupper
605
606 /* locale.h functons */
607 #define wxSetlocale setlocale
608
609 /* string.h functions */
610 #define wxStrcat strcat
611 #define wxStrchr strchr
612 #define wxStrcmp strcmp
613 #define wxStrcoll strcoll
614 #define wxStrcpy strcpy
615 #define wxStrcspn strcspn
616
617 /* wxStricmp and wxStrnicmp are defined below */
618 #define wxStrlen_ strlen /* used in wxStrlen inline function */
619 #define wxStrncat strncat
620 #define wxStrncmp strncmp
621 #define wxStrncpy strncpy
622 #define wxStrpbrk strpbrk
623 #define wxStrrchr strrchr
624 #define wxStrspn strspn
625 #define wxStrstr strstr
626 #define wxStrtod strtod
627 #ifdef HAVE_STRTOK_R
628 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
629 #endif
630 #define wxStrtol strtol
631 #define wxStrtoul strtoul
632 #define wxStrxfrm strxfrm
633
634 /* stdio.h functions */
635 #define wxFopen fopen
636 #define wxFreopen freopen
637 #define wxRemove remove
638 #define wxRename rename
639
640 #define wxPerror perror
641 #define wxTmpnam tmpnam
642
643 #define wxFgetc fgetc
644 #define wxFgetchar fgetchar
645 #define wxFgets fgets
646 #define wxFputc fputc
647 #define wxFputs fputs
648 #define wxFputchar fputchar
649 #define wxFprintf fprintf
650 #define wxFscanf fscanf
651 #define wxGetc getc
652 #define wxGetchar getchar
653 #define wxGets gets
654 #define wxPrintf printf
655 #define wxPutc putc
656 #define wxPutchar putchar
657 #define wxPuts puts
658 #define wxScanf scanf
659 #define wxSprintf sprintf
660 #define wxSscanf sscanf
661 #define wxUngetc ungetc
662 #define wxVfprintf vfprintf
663 #define wxVprintf vprintf
664 #define wxVsscanf vsscanf
665 #define wxVsprintf vsprintf
666
667 /* stdlib.h functions */
668 #define wxAtof atof
669 #define wxAtoi atoi
670 #define wxAtol atol
671 #define wxGetenv getenv
672 #define wxSystem system
673
674 /* time.h functions */
675 #define wxAsctime asctime
676 #define wxCtime ctime
677 #define wxStrftime strftime
678 #endif /* Unicode/ASCII */
679 #endif /* TCHAR-aware compilers/the others */
680
681 /*
682 various special cases
683 */
684
685 /* define wxStricmp and wxStrnicmp for various compilers */
686
687 /* note that in Unicode mode we definitely are going to need our own version */
688 #if !defined(wxStricmp) && !wxUSE_UNICODE
689 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
690 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
691 defined(__EMX__) || defined(__DJGPP__)
692 #define wxStricmp stricmp
693 #define wxStrnicmp strnicmp
694 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
695 (defined(__MWERKS__) && defined(__INTEL__))
696 #define wxStricmp _stricmp
697 #define wxStrnicmp _strnicmp
698 #elif defined(__UNIX__) || defined(__GNUWIN32__)
699 #define wxStricmp strcasecmp
700 #define wxStrnicmp strncasecmp
701 /* #else -- use wxWidgets implementation */
702 #endif
703 #endif /* !defined(wxStricmp) */
704
705 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
706 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
707 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
708 #if wxUSE_WCHAR_T
709 #ifdef HAVE_WCSLEN
710 #define wxWcslen wcslen
711 #else
712 WXDLLIMPEXP_BASE size_t wxWcslen(const wchar_t *s);
713 #endif
714 #endif /* wxUSE_WCHAR_T */
715
716 #ifdef __cplusplus
717 /* checks whether the passed in pointer is NULL and if the string is empty */
718 inline bool wxIsEmpty(const wxChar *p) { return !p || !*p; }
719
720 /* safe version of strlen() (returns 0 if passed NULL pointer) */
721 inline size_t wxStrlen(const wxChar *psz) { return psz ? wxStrlen_(psz) : 0; }
722 #endif
723
724 /*
725 each of strdup() and wcsdup() may or may not be available but we need both
726 of them anyhow for wx/buffer.h so we define the missing one(s) in
727 wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
728 defined -- if this is somehow not the case in some situations, please
729 correct that and not the lines here
730 */
731 #if wxUSE_UNICODE
732 #define wxStrdup wxStrdupW
733 #else
734 #define wxStrdup wxStrdupA
735 #endif
736
737 #ifdef __cplusplus
738 WXDLLIMPEXP_BASE bool wxOKlibc(); /* for internal use */
739 #endif
740
741 /* printf() family saga */
742
743 /*
744 For some systems vsnprintf() exists in the system libraries but not in the
745 headers, so we need to declare it ourselves to be able to use it.
746 */
747 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
748 extern "C"
749 int vsnprintf(char *str, size_t size, const char *format, va_list ap);
750 #endif /* !HAVE_VSNPRINTF_DECL */
751
752 /*
753 First of all, we always want to define safe snprintf() function to be used
754 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
755 which we really need...), otherwise we implement it using our own printf()
756 code.
757
758 We define function with a trailing underscore here because the real one is a
759 wrapper around it as explained below
760 */
761 #ifndef wxVsnprintf_
762 #if wxUSE_UNICODE
763 #if defined(__MWERKS__)
764 #define HAVE_WCSRTOMBS 1
765 #define HAVE_VSWPRINTF 1
766 #endif
767 #if defined(__WATCOMC__)
768 #define wxVsnprintf_ _vsnwprintf
769 #define wxSnprintf_ _snwprintf
770 #endif
771 #if defined(HAVE__VSNWPRINTF)
772 #define wxVsnprintf_ _vsnwprintf
773 /* MinGW?MSVCRT has the wrong vswprintf */
774 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
775 #define wxVsnprintf_ vswprintf
776 #endif
777 #else /* ASCII */
778 /* all versions of CodeWarrior supported by wxWidgets apparently have */
779 /* vsnprintf() */
780 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
781 /* assume we have snprintf() too if we have vsnprintf() */
782 #define wxVsnprintf_ vsnprintf
783 #define wxSnprintf_ snprintf
784 #endif
785 #endif
786 #endif /* wxVsnprintf_ not defined yet */
787
788 #ifndef wxSnprintf_
789 /* no [v]snprintf(), cook our own */
790 WXDLLIMPEXP_BASE int wxSnprintf_(wxChar *buf, size_t len, const wxChar *format,
791 ...) ATTRIBUTE_PRINTF_3;
792 #endif
793 #ifndef wxVsnprintf_
794 WXDLLIMPEXP_BASE int wxVsnprintf_(wxChar *buf, size_t len, const wxChar *format,
795 va_list argptr);
796 #endif
797
798 /*
799 In Unicode mode we need to have all standard functions such as wprintf() and
800 so on but not all systems have them so use our own implementations in this
801 case.
802 */
803 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
804 #define wxNEED_WPRINTF
805 #endif
806
807 /*
808 More Unicode complications: although both ANSI C and C++ define a number of
809 wide character functions such as wprintf(), not all environments have them.
810 Worse, those which do have different behaviours: under Windows, %s format
811 specifier changes its meaning in Unicode build and expects a Unicode string
812 while under Unix/POSIX it still means an ASCII string even for wprintf() and
813 %ls has to be used for wide strings.
814
815 We choose to always emulate Windows behaviour as more useful for us so even
816 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
817
818 */
819
820 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
821 /*
822 we need to implement all wide character printf and scanf functions
823 either because we don't have them at all or because they don't have the
824 semantics we need
825 */
826
827 #include <stdio.h> /* for FILE */
828
829 int wxScanf( const wxChar *format, ... ) ATTRIBUTE_PRINTF_1;
830 int wxSscanf( const wxChar *str, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
831 int wxFscanf( FILE *stream, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
832 int wxVsscanf( const wxChar *str, const wxChar *format, va_list ap );
833 int wxPrintf( const wxChar *format, ... ) ATTRIBUTE_PRINTF_1;
834 int wxSprintf( wxChar *str, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
835 int wxFprintf( FILE *stream, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
836 int wxVfprintf( FILE *stream, const wxChar *format, va_list ap );
837 int wxVprintf( const wxChar *format, va_list ap );
838 int wxVsprintf( wxChar *str, const wxChar *format, va_list ap );
839 #endif /* wxNEED_PRINTF_CONVERSION */
840
841 /* these 2 can be simply mapped to the versions with underscore at the end */
842 /* if we don't have to do the conversion */
843 /*
844 However, if we don't have any vswprintf() at all we don't need to redefine
845 anything as our own wxVsnprintf_() already behaves as needed.
846 */
847 #if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
848 int wxSnprintf( wxChar *str, size_t size, const wxChar *format, ... ) ATTRIBUTE_PRINTF_3;
849 int wxVsnprintf( wxChar *str, size_t size, const wxChar *format, va_list ap );
850 #else
851 #define wxSnprintf wxSnprintf_
852 #define wxVsnprintf wxVsnprintf_
853 #endif
854
855 /*
856 various functions which might not be available in libc and for which we
857 provide our own replacements in wxchar.cpp
858 */
859
860 /* ctype.h functions */
861
862 /* RN: Used only under OSX <= 10.2 currently */
863 #ifdef wxNEED_WX_CTYPE_H
864 WXDLLIMPEXP_BASE int wxIsalnum(wxChar ch);
865 WXDLLIMPEXP_BASE int wxIsalpha(wxChar ch);
866 WXDLLIMPEXP_BASE int wxIscntrl(wxChar ch);
867 WXDLLIMPEXP_BASE int wxIsdigit(wxChar ch);
868 WXDLLIMPEXP_BASE int wxIsgraph(wxChar ch);
869 WXDLLIMPEXP_BASE int wxIslower(wxChar ch);
870 WXDLLIMPEXP_BASE int wxIsprint(wxChar ch);
871 WXDLLIMPEXP_BASE int wxIspunct(wxChar ch);
872 WXDLLIMPEXP_BASE int wxIsspace(wxChar ch);
873 WXDLLIMPEXP_BASE int wxIsupper(wxChar ch);
874 WXDLLIMPEXP_BASE int wxIsxdigit(wxChar ch);
875 WXDLLIMPEXP_BASE int wxTolower(wxChar ch);
876 WXDLLIMPEXP_BASE int wxToupper(wxChar ch);
877 #endif /* wxNEED_WX_CTYPE_H */
878
879 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
880 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
881 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
882 #undef wxIsspace
883 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
884 #endif /* VC++ */
885
886 /*
887 a few compilers don't have the (non standard but common) isascii function,
888 define it ourselves for them
889 */
890 #ifndef isascii
891 #if defined(__MWERKS__)
892 #define wxNEED_ISASCII
893 #elif defined(_WIN32_WCE)
894 #if _WIN32_WCE <= 211
895 #define wxNEED_ISASCII
896 #endif
897 #endif
898 #endif /* isascii */
899
900 #ifdef wxNEED_ISASCII
901 inline int isascii(int c) { return (unsigned)c < 0x80; }
902 #endif
903
904 #ifdef _WIN32_WCE
905 #if _WIN32_WCE <= 211
906 #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
907 #endif
908 #endif /* _WIN32_WCE */
909
910 /*
911 we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
912 initial versions of this header -- now it is too late to remove it so
913 although we fixed the function/macro name above, still provide the
914 backwards-compatible synonym.
915 */
916 #define wxIsctrl wxIscntrl
917
918 /* string.h functions */
919 #ifndef strdup
920 #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
921 #define wxNEED_STRDUP
922 #elif defined(__WXWINCE__)
923 #if _WIN32_WCE <= 211
924 #define wxNEED_STRDUP
925 #endif
926 #endif
927 #endif /* strdup */
928
929 #ifdef wxNEED_STRDUP
930 WXDLLIMPEXP_BASE char *strdup(const char* s);
931 #endif
932
933 /* RN: Used only under OSX <= 10.2 currently
934 The __cplusplus ifdefs are messy, but they are required to build
935 the regex library, since c does not support function overloading
936 */
937 #ifdef wxNEED_WX_STRING_H
938 # ifdef __cplusplus
939 extern "C" {
940 # endif
941 WXDLLIMPEXP_BASE wxChar * wxStrcat(wxChar *dest, const wxChar *src);
942 WXDLLIMPEXP_BASE const wxChar * wxStrchr(const wxChar *s, wxChar c);
943 WXDLLIMPEXP_BASE int wxStrcmp(const wxChar *s1, const wxChar *s2);
944 WXDLLIMPEXP_BASE int wxStrcoll(const wxChar *s1, const wxChar *s2);
945 WXDLLIMPEXP_BASE wxChar * wxStrcpy(wxChar *dest, const wxChar *src);
946 WXDLLIMPEXP_BASE size_t wxStrcspn(const wxChar *s, const wxChar *reject);
947 WXDLLIMPEXP_BASE wxChar * wxStrncat(wxChar *dest, const wxChar *src, size_t n);
948 WXDLLIMPEXP_BASE int wxStrncmp(const wxChar *s1, const wxChar *s2, size_t n);
949 WXDLLIMPEXP_BASE wxChar * wxStrncpy(wxChar *dest, const wxChar *src, size_t n);
950 WXDLLIMPEXP_BASE const wxChar * wxStrpbrk(const wxChar *s, const wxChar *accept);
951 WXDLLIMPEXP_BASE const wxChar * wxStrrchr(const wxChar *s, wxChar c);
952 WXDLLIMPEXP_BASE size_t wxStrspn(const wxChar *s, const wxChar *accept);
953 WXDLLIMPEXP_BASE const wxChar * wxStrstr(const wxChar *haystack, const wxChar *needle);
954 # ifdef __cplusplus
955 }
956 # endif
957
958 /* These functions use C++, so we can't c extern them */
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
964 /* inlined versions */
965 #ifdef __cplusplus
966 inline wxChar * wxStrchr(wxChar *s, wxChar c)
967 { return (wxChar *)wxStrchr((const wxChar *)s, c); }
968 inline wxChar * wxStrpbrk(wxChar *s, const wxChar *accept)
969 { return (wxChar *)wxStrpbrk((const wxChar *)s, accept); }
970 inline wxChar * wxStrrchr(wxChar *s, wxChar c)
971 { return (wxChar *)wxStrrchr((const wxChar *)s, c); }
972 inline wxChar *wxStrstr(wxChar *haystack, const wxChar *needle)
973 { return (wxChar *)wxStrstr((const wxChar *)haystack, needle); }
974 #endif
975
976 #endif /* wxNEED_WX_STRING_H */
977
978 #ifndef wxStrdupA
979 WXDLLIMPEXP_BASE char *wxStrdupA(const char *psz);
980 #endif
981
982 #ifndef wxStrdupW
983 WXDLLIMPEXP_BASE wchar_t *wxStrdupW(const wchar_t *pwz);
984 #endif
985
986 #ifndef wxStricmp
987 WXDLLIMPEXP_BASE int wxStricmp(const wxChar *psz1, const wxChar *psz2);
988 #endif
989
990 #ifndef wxStrnicmp
991 WXDLLIMPEXP_BASE int wxStrnicmp(const wxChar *psz1, const wxChar *psz2, size_t len);
992 #endif
993
994 #ifndef wxStrtok
995 WXDLLIMPEXP_BASE wxChar * wxStrtok(wxChar *psz, const wxChar *delim, wxChar **save_ptr);
996 #endif
997
998 #ifdef __cplusplus
999 #ifndef wxSetlocale
1000 class WXDLLIMPEXP_BASE wxWCharBuffer;
1001 WXDLLIMPEXP_BASE wxWCharBuffer wxSetlocale(int category, const wxChar *locale);
1002 #endif
1003 #endif
1004
1005 /* stdio.h functions */
1006 #ifdef wxNEED_WX_STDIO_H
1007 #include <stdio.h>
1008 WXDLLIMPEXP_BASE FILE * wxFopen(const wxChar *path, const wxChar *mode);
1009 WXDLLIMPEXP_BASE FILE * wxFreopen(const wxChar *path, const wxChar *mode, FILE *stream);
1010 WXDLLIMPEXP_BASE int wxRemove(const wxChar *path);
1011 WXDLLIMPEXP_BASE int wxRename(const wxChar *oldpath, const wxChar *newpath);
1012
1013 /* *printf() family is handled separately */
1014 #endif /* wxNEED_WX_STDIO_H */
1015
1016
1017 /* stdlib.h functions */
1018 #ifndef wxAtof
1019 WXDLLIMPEXP_BASE double wxAtof(const wxChar *psz);
1020 #endif
1021
1022 #ifdef wxNEED_WX_STDLIB_H
1023 WXDLLIMPEXP_BASE int wxAtoi(const wxChar *psz);
1024 WXDLLIMPEXP_BASE long wxAtol(const wxChar *psz);
1025 WXDLLIMPEXP_BASE wxChar * wxGetenv(const wxChar *name);
1026 WXDLLIMPEXP_BASE int wxSystem(const wxChar *psz);
1027 #endif
1028
1029
1030 /* time.h functions */
1031 #ifdef wxNEED_WX_TIME_H
1032 #if defined(__MWERKS__) && defined(macintosh)
1033 #include <time.h>
1034 #endif
1035 /*silent gabby compilers*/
1036 struct tm;
1037 WXDLLIMPEXP_BASE size_t wxStrftime(wxChar *s, size_t max,
1038 const wxChar *fmt, const struct tm *tm);
1039 #endif /* wxNEED_WX_TIME_H */
1040
1041 #ifndef wxCtime
1042 #include <time.h>
1043 WXDLLIMPEXP_BASE wxChar *wxCtime(const time_t *timep);
1044 #endif
1045
1046
1047 /* missing functions in some WinCE versions */
1048 #ifdef _WIN32_WCE
1049 #if (_WIN32_WCE < 300)
1050 WXDLLIMPEXP_BASE void *calloc( size_t num, size_t size );
1051 #endif
1052 #endif /* _WIN32_WCE */
1053
1054 /* multibyte to wide char conversion functions and macros */
1055
1056 #if wxUSE_WCHAR_T
1057 /* multibyte<->widechar conversion */
1058 WXDLLIMPEXP_BASE size_t wxMB2WC(wchar_t *buf, const char *psz, size_t n);
1059 WXDLLIMPEXP_BASE size_t wxWC2MB(char *buf, const wchar_t *psz, size_t n);
1060
1061 #if wxUSE_UNICODE
1062 #define wxMB2WX wxMB2WC
1063 #define wxWX2MB wxWC2MB
1064 #define wxWC2WX wxStrncpy
1065 #define wxWX2WC wxStrncpy
1066 #else
1067 #define wxMB2WX wxStrncpy
1068 #define wxWX2MB wxStrncpy
1069 #define wxWC2WX wxWC2MB
1070 #define wxWX2WC wxMB2WC
1071 #endif
1072 #else /* !wxUSE_UNICODE */
1073 #error ha
1074 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
1075 #define wxMB2WC wxStrncpy
1076 #define wxWC2MB wxStrncpy
1077 #define wxMB2WX wxStrncpy
1078 #define wxWX2MB wxStrncpy
1079 #define wxWC2WX wxWC2MB
1080 #define wxWX2WC wxMB2WC
1081 #endif
1082
1083 //
1084 // RN: The following are not normal versions of memcpy et al., rather
1085 // these are either char or widechar versions depending on
1086 // if unicode is used or not.
1087 //
1088
1089 #ifdef __cplusplus
1090
1091 //
1092 // RN: We could do the usual tricky compiler detection here,
1093 // and use their variant (such as wmemchr, etc.). The problem
1094 // is that these functions are quite rare, even though they are
1095 // part of the current POSIX standard. In addition, most compilers
1096 // (including even MSC) inline them just like we do right in their
1097 // headers.
1098 //
1099 #if wxUSE_UNICODE
1100 #include <string.h> //for mem funcs
1101
1102 //implement our own wmem variants
1103 inline wxChar* wxMemchr(const wxChar* s, wxChar c, size_t l)
1104 {
1105 for(;l && *s != c;--l, ++s) {}
1106
1107 if(l)
1108 return (wxChar*)s;
1109 return NULL;
1110 }
1111
1112 inline int wxMemcmp(const wxChar* sz1, const wxChar* sz2, size_t len)
1113 {
1114 for(; *sz1 == *sz2 && len; --len, ++sz1, ++sz2) {}
1115
1116 if(len)
1117 return *sz1 < *sz2 ? -1 : *sz1 > *sz2;
1118 else
1119 return 0;
1120 }
1121
1122 inline wxChar* wxMemcpy(wxChar* szOut, const wxChar* szIn, size_t len)
1123 {
1124 return (wxChar*) memcpy(szOut, szIn, len * sizeof(wxChar));
1125 }
1126
1127 inline wxChar* wxMemmove(wxChar* szOut, const wxChar* szIn, size_t len)
1128 {
1129 return (wxChar*) memmove(szOut, szIn, len * sizeof(wxChar));
1130 }
1131
1132 inline wxChar* wxMemset(wxChar* szOut, const wxChar cIn, size_t len)
1133 {
1134 wxChar* szRet = szOut;
1135
1136 while (len--)
1137 *szOut++ = cIn;
1138
1139 return szRet;
1140 }
1141
1142 #else //!wxUSE_UNICODE
1143 # define wxMemchr memchr
1144 # define wxMemcmp memcmp
1145 # define wxMemcpy memcpy
1146 # define wxMemmove memmove
1147 # define wxMemset memset
1148 #endif
1149
1150 #endif /*__cplusplus*/
1151
1152
1153 #endif /* _WX_WXCHAR_H_ */
1154