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
8 * Copyright: (c) 1998-2002 wxWindows dev team
9 * Licence: wxWindows licence
12 /* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
17 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
18 #pragma interface "wxchar.h"
21 #include "wx/defs.h" /* for wxUSE_UNICODE */
23 /* ---------------------------------------------------------------------------- */
24 /* check whether we have wchar_t and which size it is if we do */
25 /* ---------------------------------------------------------------------------- */
27 #if !defined(wxUSE_WCHAR_T)
28 #if defined(__WIN16__)
29 /* no wchar_t under Win16 regadrless of compiler used */
30 #define wxUSE_WCHAR_T 0
31 #elif defined(__UNIX__)
32 #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || defined(__DARWIN__)
33 #define wxUSE_WCHAR_T 1
35 #define wxUSE_WCHAR_T 0
37 #elif defined(__GNUWIN32__) && !defined(__MINGW32__)
38 #define wxUSE_WCHAR_T 0
39 #elif defined(__WATCOMC__)
40 #define wxUSE_WCHAR_T 0
41 #elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
42 #define wxUSE_WCHAR_T 0
44 /* add additional compiler checks if this fails */
45 #define wxUSE_WCHAR_T 1
47 #endif /* !defined(wxUSE_WCHAR_T) */
49 /* Unicode support requires wchar_t */
50 #if wxUSE_UNICODE && !wxUSE_WCHAR_T
51 #error "wchar_t must be available in Unicode build"
54 /* ---------------------------------------------------------------------------- */
55 /* standard headers we need here */
57 /* NB: don't include any wxWindows headers here because almost of them include */
59 /* ---------------------------------------------------------------------------- */
61 /* Required for wxPrintf() etc */
64 /* Almost all compiler have strdup(), but not quite all: CodeWarrior under Mac */
65 /* and VC++ for Windows CE don't provide it */
66 #if !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
67 /* use #define, not inline wrapper, as it is tested with #ifndef below */
68 #define wxStrdupA strdup
71 /* non Unix compilers which do have wchar.h (but not tchar.h which is included */
72 /* below and which includes wchar.h anyhow). */
73 /* Actually MinGW has tchar.h, but it does not include wchar.h */
74 #if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__) || defined(__WATCOMC__)
82 /* the current (as of Nov 2002) version of cygwin has a bug in its */
83 /* wchar.h -- there is no extern "C" around the declarations in it and */
84 /* this results in linking errors later; also, at least on some */
85 /* Cygwin versions, wchar.h requires sys/types.h */
87 #include <sys/types.h>
94 #elif defined(HAVE_WCSTR_H)
95 /* old compilers have relevant declarations here */
97 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
98 /* include stdlib.h for wchar_t */
100 #endif /* HAVE_WCHAR_H */
101 #endif /* wxUSE_WCHAR_T */
103 /* ---------------------------------------------------------------------------- */
104 /* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
105 /* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
106 /* the function mapping _tfoo() -> foo() or wfoo() */
107 /* ---------------------------------------------------------------------------- */
109 /* VC++ and BC++ starting with 5.2 have TCHAR support */
111 #define wxHAVE_TCHAR_SUPPORT
112 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
113 #define wxHAVE_TCHAR_SUPPORT
115 #elif defined(__WATCOMC__)
116 #define wxHAVE_TCHAR_SUPPORT
117 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 )
118 #define wxHAVE_TCHAR_SUPPORT
122 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
123 /* VZ: the old VisualAge definitions were completely wrong and had no */
124 /* chance at all to work in Unicode build anyhow so let's pretend that */
125 /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
126 /* "0 &&" above) until someone really has time to delve into Unicode */
127 /* issues under OS/2 */
129 /* VisualAge 4.0+ supports TCHAR */
130 #define wxHAVE_TCHAR_SUPPORT
131 #endif /* compilers with (good) TCHAR support */
137 #ifdef wxHAVE_TCHAR_SUPPORT
138 /* get TCHAR definition if we've got it */
141 /* we surely do have wchar_t if we have TCHAR */
142 #ifndef wxUSE_WCHAR_T
143 #define wxUSE_WCHAR_T 1
144 #endif /* !defined(wxUSE_WCHAR_T) */
146 /* and we also do have wcslen() */
150 #endif /* wxHAVE_TCHAR_SUPPORT */
152 /* ---------------------------------------------------------------------------- */
153 /* define wxChar type */
154 /* ---------------------------------------------------------------------------- */
156 /* TODO: define wxCharInt to be equal to either int or wint_t? */
160 typedef signed char wxSChar
;
161 typedef unsigned char wxUChar
;
163 /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
164 /* signed/unsigned version of it which (a) makes sense to me (unlike */
165 /* char wchar_t is always unsigned) and (b) was how the previous */
166 /* definitions worked so keep it like this */
168 /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
170 #if !defined(__WCHAR_TYPE__) || \
171 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
173 typedef wchar_t wxChar
;
174 typedef wchar_t wxSChar
;
175 typedef wchar_t wxUChar
;
176 #else /* __WCHAR_TYPE__ and gcc < 2.96 */
177 /* VS: wxWindows used to define wxChar as __WCHAR_TYPE__ here. However, */
178 /* this doesn't work with new GCC 3.x compilers because wchar_t is */
179 /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
180 /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
181 /* have to define wxChar conditionally depending on detected */
182 /* compiler & compiler version. */
183 /* with old definition of wxChar. */
184 typedef __WCHAR_TYPE__ wxChar
;
185 typedef __WCHAR_TYPE__ wxSChar
;
186 typedef __WCHAR_TYPE__ wxUChar
;
187 #endif /* __WCHAR_TYPE__ */
188 #endif /* ASCII/Unicode */
190 /* ---------------------------------------------------------------------------- */
191 /* define _T() and related macros */
192 /* ---------------------------------------------------------------------------- */
194 /* BSD systems define _T() to be something different in ctype.h, override it */
195 #if defined(__FreeBSD__) || defined(__DARWIN__)
200 /* could already be defined by tchar.h (it's quasi standard) */
206 #endif /* ASCII/Unicode */
207 #endif /* !defined(_T) */
209 /* although global macros with such names are normally bad, we want to have */
210 /* another name for _T() which should be used to avoid confusion between _T() */
211 /* and _() in wxWindows sources */
214 /* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
216 #define __XFILE__(x) wxT(x)
217 #define __TFILE__ __XFILE__(__FILE__)
221 #define __XDATE__(x) wxT(x)
222 #define __TDATE__ __XDATE__(__DATE__)
226 #define __XTIME__(x) wxT(x)
227 #define __TTIME__ __XTIME__(__TIME__)
230 /* ---------------------------------------------------------------------------- */
231 /* define wxFoo() function for each standard foo() function whose signature */
232 /* (exceptionally including the return type) includes any mention of char: */
233 /* wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have */
234 /* the same signature but with char replaced by wxChar which allows us to use */
235 /* it in Unicode build as well */
236 /* ---------------------------------------------------------------------------- */
238 #ifdef wxHAVE_TCHAR_SUPPORT
241 /* ctype.h functions */
242 #define wxIsalnum _istalnum
243 #define wxIsalpha _istalpha
244 #define wxIsctrl _istctrl
245 #define wxIsdigit _istdigit
246 #define wxIsgraph _istgraph
247 #define wxIslower _istlower
248 #define wxIsprint _istprint
249 #define wxIspunct _istpunct
250 #define wxIsspace _istspace
251 #define wxIsupper _istupper
252 #define wxIsxdigit _istxdigit
253 #define wxTolower _totlower
254 #define wxToupper _totupper
256 /* locale.h functons */
257 #define wxSetlocale _tsetlocale
259 /* string.h functions */
260 #define wxStrcat _tcscat
261 #define wxStrchr _tcschr
262 #define wxStrcmp _tcscmp
263 #define wxStrcoll _tcscoll
264 #define wxStrcpy _tcscpy
265 #define wxStrcspn _tcscspn
266 #define wxStrdupW _wcsdup /* notice the 'W'! */
267 #define wxStrftime _tcsftime
268 #define wxStricmp _tcsicmp
269 #define wxStrnicmp _tcsnicmp
270 #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
271 #define wxStrncat _tcsncat
272 #define wxStrncmp _tcsncmp
273 #define wxStrncpy _tcsncpy
274 #define wxStrpbrk _tcspbrk
275 #define wxStrrchr _tcsrchr
276 #define wxStrspn _tcsspn
277 #define wxStrstr _tcsstr
278 #define wxStrtod _tcstod
279 #define wxStrtol _tcstol
280 #define wxStrtoul _tcstoul
281 #define wxStrxfrm _tcsxfrm
283 /* stdio.h functions */
284 #define wxFgetc _fgettc
285 #define wxFgetchar _fgettchar
286 #define wxFgets _fgetts
287 #define wxFopen _tfopen
288 #define wxFputc _fputtc
289 #define wxFputchar _fputtchar
290 #define wxFprintf _ftprintf
291 #define wxFputs _fputts
292 #define wxFreopen _tfreopen
293 #define wxFscanf _ftscanf
294 #define wxGetc _gettc
295 #define wxGetchar _gettchar
296 #define wxGets _getts
297 #define wxPerror _tperror
298 #define wxPrintf _tprintf
299 #define wxPutc _puttc
300 #define wxPutchar _puttchar
301 #define wxPuts _putts
302 #define wxScanf _tscanf
303 #define wxSprintf _stprintf
304 #define wxSscanf _stscanf
305 #define wxTmpnam _ttmpnam
306 #define wxUngetc _tungetc
307 #define wxVfprintf _vftprintf
308 #define wxVprintf _vtprintf
309 #define wxVsscanf _vstscanf
310 #define wxVsprintf _vstprintf
312 /* special case: not all TCHAR-aware compilers have those */
313 #if defined(__VISUALC__) || \
314 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
315 #define wxVsnprintf_ _vsntprintf
316 #define wxSnprintf_ _sntprintf
319 /* special case: these functions are missing under Win9x with Unicows so we */
320 /* have to implement them ourselves */
321 #if wxUSE_UNICODE_MSLU
322 #define wxRemove wxMSLU__tremove
323 #define wxRename wxMSLU__trename
326 #define wxRemove DeleteFile
328 #define wxRemove _tremove
329 #define wxRename _trename
333 /* stdlib.h functions */
336 /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
337 #define wxGetenv _tgetenv
338 #define wxSystem _tsystem
340 /* time.h functions */
341 #define wxAsctime _tasctime
342 #define wxCtime _tctime
343 #else /* !TCHAR-aware compilers */
347 /* this is probably glibc-specific */
348 #if defined(__WCHAR_TYPE__)
349 /* ctype.h functions (wctype.h) */
350 #define wxIsalnum iswalnum
351 #define wxIsalpha iswalpha
352 #define wxIsctrl iswcntrl
353 #define wxIsdigit iswdigit
354 #define wxIsgraph iswgraph
355 #define wxIslower iswlower
356 #define wxIsprint iswprint
357 #define wxIspunct iswpunct
358 #define wxIsspace iswspace
359 #define wxIsupper iswupper
360 #define wxIsxdigit iswxdigit
362 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
363 /* /usr/include/wctype.h incorrectly declares translations */
364 /* tables which provokes tons of compile-time warnings -- try */
365 /* to correct this */
366 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
367 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
368 #else /* !glibc 2.0 */
369 #define wxTolower towlower
370 #define wxToupper towupper
371 #endif /* gcc/!gcc */
373 /* string.h functions (wchar.h) */
374 #define wxStrcat wcscat
375 #define wxStrchr wcschr
376 #define wxStrcmp wcscmp
377 #define wxStrcoll wcscoll
378 #define wxStrcpy wcscpy
379 #define wxStrcspn wcscspn
380 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
381 #define wxStrncat wcsncat
382 #define wxStrncmp wcsncmp
383 #define wxStrncpy wcsncpy
384 #define wxStrpbrk wcspbrk
385 #define wxStrrchr wcsrchr
386 #define wxStrspn wcsspn
387 #define wxStrstr wcsstr
388 #define wxStrtod wcstod
389 #define wxStrtol wcstol
390 #define wxStrtoul wcstoul
391 #define wxStrxfrm wcsxfrm
393 #define wxFgetc fgetwc
394 #define wxFgetchar fgetwchar
395 #define wxFgets fgetws
396 #define wxFputc fputwc
397 #define wxFputchar fputwchar
399 #define wxGetchar getwchar
401 #define wxUngetc ungetwc
405 #define wxPutchar wputchar
407 #define wxFputs fputws
409 #define wxNEED_FPUTWC
413 int wxFputs(const wxChar
*ch
, FILE *stream
);
414 int wxPutc(wxChar ch
, FILE *stream
);
416 #define wxPuts(ws) wxFputs(ws, stdout)
417 #define wxPutchar(wch) wxPutc(wch, stdout)
420 /* we need %s to %ls conversion for printf and scanf etc */
421 #define wxNEED_PRINTF_CONVERSION
423 /* glibc doesn't have wide char equivalents of the other stuff so */
424 /* use our own versions */
425 #define wxNEED_WX_STDIO_H
426 #define wxNEED_WX_STDLIB_H
427 #define wxNEED_WX_TIME_H
428 #elif defined(__MWERKS__) && ( defined(macintosh) || defined(__MACH__) )
429 /* ctype.h functions (wctype.h) */
430 #define wxIsalnum iswalnum
431 #define wxIsalpha iswalpha
432 #define wxIsctrl iswcntrl
433 #define wxIsdigit iswdigit
434 #define wxIsgraph iswgraph
435 #define wxIslower iswlower
436 #define wxIsprint iswprint
437 #define wxIspunct iswpunct
438 #define wxIsspace iswspace
439 #define wxIsupper iswupper
440 #define wxIsxdigit iswxdigit
441 #define wxTolower towlower
442 #define wxToupper towupper
444 /* string.h functions (wchar.h) */
445 #define wxStrcat wcscat
446 #define wxStrchr wcschr
447 #define wxStrcmp wcscmp
448 #define wxStrcoll wcscoll
449 #define wxStrcpy wcscpy
450 #define wxStrcspn wcscspn
451 #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
452 #define wxStrncat wcsncat
453 #define wxStrncmp wcsncmp
454 #define wxStrncpy wcsncpy
455 #define wxStrpbrk wcspbrk
456 #define wxStrrchr wcsrchr
457 #define wxStrspn wcsspn
458 #define wxStrstr wcsstr
459 #define wxStrtod wcstod
460 #define wxStrtol wcstol
461 #define wxStrtoul wcstoul
462 #define wxStrxfrm wcsxfrm
464 #define wxFgetc fgetwc
465 #define wxFgetchar fgetwchar
466 #define wxFgets fgetws
467 #define wxFputc fputwc
468 #define wxFputchar fputwchar
470 #define wxGetchar getwchar
472 #define wxUngetc ungetwc
474 #define wxNEED_PRINTF_CONVERSION
477 #define wxPutchar putwchar
478 #define wxFputs fputws
480 /* stdio.h functions */
482 #define wxNEED_WX_STDIO_H
484 /* stdlib.h functions */
488 #define wxGetenv(a) ((wxChar*)NULL)
489 #define wxSystem(a) ((int)NULL)
491 /* time.h functions */
492 #define wxAsctime wasciitime
493 #define wxCtime wctime
494 /* #define wxStrftime wcsftime */
497 #define wxNEED_FPUTWC
501 int wxFputs(const wxChar *ch, FILE *stream);
502 int wxPutc(wxChar ch, FILE *stream);
504 #define wxPuts(ws) wxFputs(ws, stdout)
505 #define wxPutchar(wch) wxPutc(wch, stdout)
507 #define wxNEED_PRINTF_CONVERSION
508 #define wxNEED_WX_STDIO_H
509 #define wxNEED_WX_STDLIB_H
511 #define wxNEED_WX_TIME_H
512 #else /* !metrowerks for apple */
513 #error "Please define wide character functions for your environment"
519 /* ctype.h functions */
520 #define wxIsalnum isalnum
521 #define wxIsalpha isalpha
522 #define wxIsctrl isctrl
523 #define wxIsdigit isdigit
524 #define wxIsgraph isgraph
525 #define wxIslower islower
526 #define wxIsprint isprint
527 #define wxIspunct ispunct
528 #define wxIsspace isspace
529 #define wxIsupper isupper
530 #define wxIsxdigit isxdigit
531 #define wxTolower tolower
532 #define wxToupper toupper
534 /* locale.h functons */
535 #define wxSetlocale setlocale
537 /* string.h functions */
538 #define wxStrcat strcat
539 #define wxStrchr strchr
540 #define wxStrcmp strcmp
541 #define wxStrcoll strcoll
542 #define wxStrcpy strcpy
543 #define wxStrcspn strcspn
545 /* wxStricmp and wxStrnicmp are defined below */
546 #define wxStrlen_ strlen /* used in wxStrlen inline function */
547 #define wxStrncat strncat
548 #define wxStrncmp strncmp
549 #define wxStrncpy strncpy
550 #define wxStrpbrk strpbrk
551 #define wxStrrchr strrchr
552 #define wxStrspn strspn
553 #define wxStrstr strstr
554 #define wxStrtod strtod
556 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
558 #define wxStrtol strtol
559 #define wxStrtoul strtoul
560 #define wxStrxfrm strxfrm
562 /* stdio.h functions */
563 #define wxFopen fopen
564 #define wxFreopen freopen
565 #define wxRemove remove
566 #define wxRename rename
568 #define wxPerror perror
569 #define wxTmpnam tmpnam
571 #define wxFgetc fgetc
572 #define wxFgetchar fgetchar
573 #define wxFgets fgets
574 #define wxFputc fputc
575 #define wxFputs fputs
576 #define wxFputchar fputchar
577 #define wxFprintf fprintf
578 #define wxFscanf fscanf
580 #define wxGetchar getchar
582 #define wxPrintf printf
584 #define wxPutchar putchar
586 #define wxScanf scanf
587 #define wxSprintf sprintf
588 #define wxSscanf sscanf
589 #define wxUngetc ungetc
590 #define wxVfprintf vfprintf
591 #define wxVprintf vprintf
592 #define wxVsscanf vsscanf
593 #define wxVsprintf vsprintf
595 /* stdlib.h functions */
599 #define wxGetenv getenv
600 #define wxSystem system
602 /* time.h functions */
603 #define wxAsctime asctime
604 #define wxCtime ctime
605 #define wxStrftime strftime
606 #endif /* Unicode/ASCII */
607 #endif /* TCHAR-aware compilers/the others */
609 /* ---------------------------------------------------------------------------- */
610 /* various special cases */
611 /* ---------------------------------------------------------------------------- */
613 /* define wxStricmp and wxStrnicmp for various compilers */
615 /* note that in Unicode mode we definitely are going to need our own version */
616 #if !defined(wxStricmp) && !wxUSE_UNICODE
617 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
618 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
619 defined(__EMX__) || defined(__DJGPP__)
620 #define wxStricmp stricmp
621 #define wxStrnicmp strnicmp
622 #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
623 (defined(__MWERKS__) && defined(__INTEL__))
624 #define wxStricmp _stricmp
625 #define wxStrnicmp _strnicmp
626 #elif defined(__UNIX__) || defined(__GNUWIN32__)
627 #define wxStricmp strcasecmp
628 #define wxStrnicmp strncasecmp
629 /* #else -- use wxWindows implementation */
631 #endif /* !defined(wxStricmp) */
633 /* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
634 /* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
635 /* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
638 #define wxWcslen wcslen
640 inline size_t wxWcslen(const wchar_t *s
)
649 #endif /* wxUSE_WCHAR_T */
652 /* checks whether the passed in pointer is NULL and if the string is empty */
653 inline bool wxIsEmpty(const wxChar
*p
) { return !p
|| !*p
; }
655 /* safe version of strlen() (returns 0 if passed NULL pointer) */
656 inline size_t wxStrlen(const wxChar
*psz
) { return psz
? wxStrlen_(psz
) : 0; }
659 /* each of strdup() and wcsdup() may or may not be available but we need both */
660 /* of them anyhow for wx/buffer.h so we define the missing one(s) in */
661 /* wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW */
662 /* defined -- if this is somehow not the case in some situations, please */
663 /* correct that and not the lines here */
665 #define wxStrdup wxStrdupW
667 #define wxStrdup wxStrdupA
671 WXDLLIMPEXP_BASE
bool wxOKlibc(); /* for internal use */
673 /* ---------------------------------------------------------------------------- */
674 /* printf() family saga */
675 /* ---------------------------------------------------------------------------- */
678 For some systems vsnprintf() exists in the system libraries but not in the
679 headers, so we need to declare it ourselves to be able to use it.
681 #if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
683 int vsnprintf(char *str
, size_t size
, const char *format
, va_list ap
);
684 #endif /* !HAVE_VSNPRINTF_DECL */
687 First of all, we always want to define safe snprintf() function to be used
688 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
689 which we really need...), otherwise we implement it using our own printf()
692 We define function with a trailing underscore here because the real one is a
693 wrapper around it as explained below
697 #if defined(__MWERKS__)
698 #define HAVE_WCSRTOMBS 1
699 #define HAVE_VSWPRINTF 1
701 #if defined(__WATCOMC__)
702 #define wxVsnprintf_ _vsnwprintf
703 #define wxSnprintf_ _snwprintf
705 #if defined(HAVE__VSNWPRINTF)
706 #define wxVsnprintf_ _vsnwprintf
707 /* MinGW?MSVCRT has the wrong vswprintf */
708 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
709 #define wxVsnprintf_ vswprintf
712 /* all versions of CodeWarrior supported by wxWindows apparently have */
714 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
715 /* assume we have snprintf() too if we have vsnprintf() */
716 #define wxVsnprintf_ vsnprintf
717 #define wxSnprintf_ snprintf
720 #endif /* wxVsnprintf_ not defined yet */
723 /* no [v]snprintf(), cook our own */
724 WXDLLIMPEXP_BASE
int wxSnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
725 ...) ATTRIBUTE_PRINTF_3
;
728 WXDLLIMPEXP_BASE
int wxVsnprintf_(wxChar
*buf
, size_t len
, const wxChar
*format
,
733 In Unicode mode we need to have all standard functions such as wprintf() and
734 so on but not all systems have them so use our own implementations in this
737 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
738 #define wxNEED_WPRINTF
742 More Unicode complications: although both ANSI C and C++ define a number of
743 wide character functions such as wprintf(), not all environments have them.
744 Worse, those which do have different behaviours: under Windows, %s format
745 specifier changes its meaning in Unicode build and expects a Unicode string
746 while under Unix/POSIX it still means an ASCII string even for wprintf() and
747 %ls has to be used for wide strings.
749 We choose to always emulate Windows behaviour as more useful for us so even
750 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
752 However, if we don't have any vswprintf() at all we don't need to redefine
753 anything as our own wxVsnprintf_() already behaves as needed.
756 #undef wxNEED_PRINTF_CONVERSION
759 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
760 /* we need to implement all wide character printf and scanf functions */
761 /* either because we don't have them at all or because they don't have the */
762 /* semantics we need */
764 #include <stdio.h> /* for FILE */
766 int wxScanf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
767 int wxSscanf( const wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
768 int wxFscanf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
769 int wxVsscanf( const wxChar
*str
, const wxChar
*format
, va_list ap
);
770 int wxPrintf( const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_1
;
771 int wxSprintf( wxChar
*str
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
772 int wxFprintf( FILE *stream
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_2
;
773 int wxVfprintf( FILE *stream
, const wxChar
*format
, va_list ap
);
774 int wxVprintf( const wxChar
*format
, va_list ap
);
775 int wxVsprintf( wxChar
*str
, const wxChar
*format
, va_list ap
);
776 #endif /* wxNEED_PRINTF_CONVERSION */
778 /* these 2 can be simply mapped to the versions with underscore at the end */
779 /* if we don't have to do the conversion */
780 #ifdef wxNEED_PRINTF_CONVERSION
781 int wxSnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, ... ) ATTRIBUTE_PRINTF_3
;
782 int wxVsnprintf( wxChar
*str
, size_t size
, const wxChar
*format
, va_list ap
);
784 #define wxSnprintf wxSnprintf_
785 #define wxVsnprintf wxVsnprintf_
788 /* ---------------------------------------------------------------------------- */
789 /* various functions which might not be available in libc and for which we */
790 /* provide our own replacements in wxchar.cpp */
791 /* ---------------------------------------------------------------------------- */
793 /* ctype.h functions */
795 /* VZ: note that this is never defined currently */
796 #ifdef wxNEED_WX_CTYPE_H
797 WXDLLIMPEXP_BASE
int wxIsalnum(wxChar ch
);
798 WXDLLIMPEXP_BASE
int wxIsalpha(wxChar ch
);
799 WXDLLIMPEXP_BASE
int wxIsctrl(wxChar ch
);
800 WXDLLIMPEXP_BASE
int wxIsdigit(wxChar ch
);
801 WXDLLIMPEXP_BASE
int wxIsgraph(wxChar ch
);
802 WXDLLIMPEXP_BASE
int wxIslower(wxChar ch
);
803 WXDLLIMPEXP_BASE
int wxIsprint(wxChar ch
);
804 WXDLLIMPEXP_BASE
int wxIspunct(wxChar ch
);
805 WXDLLIMPEXP_BASE
int wxIsspace(wxChar ch
);
806 WXDLLIMPEXP_BASE
int wxIsupper(wxChar ch
);
807 WXDLLIMPEXP_BASE
int wxIsxdigit(wxChar ch
);
808 WXDLLIMPEXP_BASE
int wxTolower(wxChar ch
);
809 WXDLLIMPEXP_BASE
int wxToupper(wxChar ch
);
810 #endif /* wxNEED_WX_CTYPE_H */
812 /* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
813 /* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
814 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
816 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
820 /* string.h functions */
822 /* VZ: this is never defined neither currently */
823 #ifdef wxNEED_WX_STRING_H
824 WXDLLIMPEXP_BASE wxChar
* wxStrcat(wxChar
*dest
, const wxChar
*src
);
825 WXDLLIMPEXP_BASE
const wxChar
* wxStrchr(const wxChar
*s
, wxChar c
);
826 WXDLLIMPEXP_BASE wxChar
* wxStrchr(wxChar
*s
, wxChar c
)
827 { return (wxChar
*)wxStrchr((const wxChar
*)s
, c
); }
828 WXDLLIMPEXP_BASE
int wxStrcmp(const wxChar
*s1
, const wxChar
*s2
);
829 WXDLLIMPEXP_BASE
int wxStrcoll(const wxChar
*s1
, const wxChar
*s2
);
830 WXDLLIMPEXP_BASE wxChar
* wxStrcpy(wxChar
*dest
, const wxChar
*src
);
831 WXDLLIMPEXP_BASE
size_t wxStrcspn(const wxChar
*s
, const wxChar
*reject
);
832 WXDLLIMPEXP_BASE
size_t wxStrlen(const wxChar
*s
);
833 WXDLLIMPEXP_BASE wxChar
* wxStrncat(wxChar
*dest
, const wxChar
*src
, size_t n
);
834 WXDLLIMPEXP_BASE
int wxStrncmp(const wxChar
*s1
, const wxChar
*s2
, size_t n
);
835 WXDLLIMPEXP_BASE wxChar
* wxStrncpy(wxChar
*dest
, const wxChar
*src
, size_t n
);
836 WXDLLIMPEXP_BASE
const wxChar
* wxStrpbrk(const wxChar
*s
, const wxChar
*accept
);
837 WXDLLIMPEXP_BASE wxChar
* wxStrpbrk(wxChar
*s
, const wxChar
*accept
)
838 { return (wxChar
*)wxStrpbrk((const wxChar
*)s
, accept
); }
839 WXDLLIMPEXP_BASE
const wxChar
* wxStrrchr(const wxChar
*s
, wxChar c
);
840 WXDLLIMPEXP_BASE wxChar
* wxStrrchr(wxChar
*s
, wxChar c
)
841 { return (wxChar
*)wxStrrchr((const wxChar
*)s
, c
); }
842 WXDLLIMPEXP_BASE
size_t wxStrspn(const wxChar
*s
, const wxChar
*accept
);
843 WXDLLIMPEXP_BASE
const wxChar
* wxStrstr(const wxChar
*haystack
, const wxChar
*needle
);
844 WXDLLIMPEXP_BASE wxChar
*wxStrstr(wxChar
*haystack
, const wxChar
*needle
)
845 { return (wxChar
*)wxStrstr((const wxChar
*)haystack
, needle
); }
846 WXDLLIMPEXP_BASE
double wxStrtod(const wxChar
*nptr
, wxChar
**endptr
);
847 WXDLLIMPEXP_BASE
long int wxStrtol(const wxChar
*nptr
, wxChar
**endptr
, int base
);
848 WXDLLIMPEXP_BASE
unsigned long int wxStrtoul(const wxChar
*nptr
, wxChar
**endptr
, int base
);
849 WXDLLIMPEXP_BASE
size_t wxStrxfrm(wxChar
*dest
, const wxChar
*src
, size_t n
);
850 #endif /* wxNEED_WX_STRING_H */
853 WXDLLIMPEXP_BASE
char *wxStrdupA(const char *psz
);
857 WXDLLIMPEXP_BASE
wchar_t *wxStrdupW(const wchar_t *pwz
);
861 WXDLLIMPEXP_BASE
int wxStricmp(const wxChar
*psz1
, const wxChar
*psz2
);
865 WXDLLIMPEXP_BASE
int wxStrnicmp(const wxChar
*psz1
, const wxChar
*psz2
, size_t len
);
869 WXDLLIMPEXP_BASE wxChar
* wxStrtok(wxChar
*psz
, const wxChar
*delim
, wxChar
**save_ptr
);
874 class WXDLLIMPEXP_BASE wxWCharBuffer
;
875 WXDLLIMPEXP_BASE wxWCharBuffer
wxSetlocale(int category
, const wxChar
*locale
);
879 /* stdio.h functions */
880 #ifdef wxNEED_WX_STDIO_H
882 WXDLLIMPEXP_BASE
FILE * wxFopen(const wxChar
*path
, const wxChar
*mode
);
883 WXDLLIMPEXP_BASE
FILE * wxFreopen(const wxChar
*path
, const wxChar
*mode
, FILE *stream
);
884 WXDLLIMPEXP_BASE
int wxRemove(const wxChar
*path
);
885 WXDLLIMPEXP_BASE
int wxRename(const wxChar
*oldpath
, const wxChar
*newpath
);
887 /* *printf() family is handled separately */
888 #endif /* wxNEED_WX_STDIO_H */
891 /* stdlib.h functions */
893 WXDLLIMPEXP_BASE
double wxAtof(const wxChar
*psz
);
896 #ifdef wxNEED_WX_STDLIB_H
897 WXDLLIMPEXP_BASE
int wxAtoi(const wxChar
*psz
);
898 WXDLLIMPEXP_BASE
long wxAtol(const wxChar
*psz
);
899 WXDLLIMPEXP_BASE wxChar
* wxGetenv(const wxChar
*name
);
900 WXDLLIMPEXP_BASE
int wxSystem(const wxChar
*psz
);
904 /* time.h functions */
905 #ifdef wxNEED_WX_TIME_H
906 #if defined(__MWERKS__) && defined(macintosh)
909 WXDLLIMPEXP_BASE
size_t wxStrftime(wxChar
*s
, size_t max
,
910 const wxChar
*fmt
, const struct tm
*tm
);
911 #endif /* wxNEED_WX_TIME_H */
913 /* missing functions in some WinCE versions */
915 #if (_WIN32_WCE < 300)
916 WXDLLIMPEXP_BASE
void *calloc( size_t num
, size_t size
);
918 WXDLLIMPEXP_BASE
char* strdup(const char* s
);
920 #if _WIN32_WCE <= 211
921 WXDLLIMPEXP_BASE
int isspace(int c
);
922 WXDLLIMPEXP_BASE
int isascii( int c
);
926 /* ---------------------------------------------------------------------------- */
927 /* multibyte to wide char conversion functions and macros */
928 /* ---------------------------------------------------------------------------- */
931 /* multibyte<->widechar conversion */
932 WXDLLIMPEXP_BASE
size_t wxMB2WC(wchar_t *buf
, const char *psz
, size_t n
);
933 WXDLLIMPEXP_BASE
size_t wxWC2MB(char *buf
, const wchar_t *psz
, size_t n
);
936 #define wxMB2WX wxMB2WC
937 #define wxWX2MB wxWC2MB
938 #define wxWC2WX wxStrncpy
939 #define wxWX2WC wxStrncpy
941 #define wxMB2WX wxStrncpy
942 #define wxWX2MB wxStrncpy
943 #define wxWC2WX wxWC2MB
944 #define wxWX2WC wxMB2WC
946 #else /* !wxUSE_UNICODE */
947 /* No wxUSE_WCHAR_T: we have to do something (JACS) */
948 #define wxMB2WC wxStrncpy
949 #define wxWC2MB wxStrncpy
950 #define wxMB2WX wxStrncpy
951 #define wxWX2MB wxStrncpy
952 #define wxWC2WX wxWC2MB
953 #define wxWX2WC wxMB2WC
956 #endif /* _WX_WXCHAR_H_ */