]> git.saurik.com Git - wxWidgets.git/blob - include/wx/wxchar.h
tried to clean strdup() mess: we now have wxStrdup[AW] which should be always available
[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
6 // Created: 1998/06/12
7 // RCS-ID: $Id$
8 // Copyright: (c) 1998-2002 wxWindows dev team
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifndef _WX_WXCHAR_H_
13 #define _WX_WXCHAR_H_
14
15 #if defined(__GNUG__) && !defined(__APPLE__)
16 #pragma interface "wxchar.h"
17 #endif
18
19 // ----------------------------------------------------------------------------
20 // first deal with Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
21 // and is used by wxWindows, _UNICODE and/or UNICODE may be defined or used by
22 // the system headers so bring these settings in sync
23 // ----------------------------------------------------------------------------
24
25 // set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined
26 #if defined(_UNICODE) || defined(UNICODE)
27 #undef wxUSE_UNICODE
28 #define wxUSE_UNICODE 1
29 #else
30 #ifndef wxUSE_UNICODE
31 #define wxUSE_UNICODE 0
32 #endif
33 #endif // Unicode
34
35 // and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1...
36 #if wxUSE_UNICODE
37 #ifndef _UNICODE
38 #define _UNICODE
39 #endif
40 #ifndef UNICODE
41 #define UNICODE
42 #endif
43 #endif // Unicode
44
45 // check whether we have wchar_t
46 #if !defined(wxUSE_WCHAR_T)
47 #if defined(__WIN16__)
48 // no wchar_t under Win16 regadrless of compiler used
49 #define wxUSE_WCHAR_T 0
50 #elif defined(__UNIX__)
51 #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || defined(__DARWIN__)
52 #define wxUSE_WCHAR_T 1
53 #else
54 #define wxUSE_WCHAR_T 0
55 #endif
56 #elif defined(__GNUWIN32__) && !defined(__MINGW32__)
57 #define wxUSE_WCHAR_T 0
58 #elif defined(__WATCOMC__)
59 #define wxUSE_WCHAR_T 0
60 #elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
61 #define wxUSE_WCHAR_T 0
62 #else
63 // add additional compiler checks if this fails
64 #define wxUSE_WCHAR_T 1
65 #endif
66 #endif // !defined(wxUSE_WCHAR_T)
67
68 // Unicode support requires wchar_t
69 #if wxUSE_UNICODE && !wxUSE_WCHAR_T
70 #error "wchar_t must be available in Unicode build"
71 #endif // Unicode
72
73 // ----------------------------------------------------------------------------
74 // standard headers we need here
75 //
76 // NB: don't include any wxWindows headers here because almost of them include
77 // this one!
78 // ----------------------------------------------------------------------------
79
80 // Required for wxPrintf() etc
81 #include <stdarg.h>
82
83 // Almost all compiler have strdup(), but not quite all: CodeWarrior under Mac
84 // and VC++ for Windows CE don't provide it
85 #if !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
86 // use #define, not inline wrapper, as it is tested with #ifndef below
87 #define wxStrdupA strdup
88 #endif
89
90 // non Unix compilers which do have wchar.h (but not tchar.h which is included
91 // below and which includes wchar.h anyhow).
92 // Actually MinGW has tchar.h, but it does not include wchar.h
93 #if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__)
94 #ifndef HAVE_WCHAR_H
95 #define HAVE_WCHAR_H
96 #endif
97 #endif
98
99 #if wxUSE_WCHAR_T
100 #ifdef HAVE_WCHAR_H
101 // the current (as of Nov 2002) version of cygwin has a bug in its
102 // wchar.h -- there is no extern "C" around the declarations in it and
103 // this results in linking errors later; also, at least on some
104 // Cygwin versions, wchar.h requires sys/types.h
105 #ifdef __CYGWIN__
106 #include <sys/types.h>
107 extern "C" {
108 #endif // Cygwin
109 #include <wchar.h>
110 #ifdef __CYGWIN__
111 }
112 #endif // Cygwin
113 #elif defined(HAVE_WCSTR_H)
114 // old compilers have relevant declarations here
115 #include <wcstr.h>
116 #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
117 // include stdlib.h for wchar_t
118 #include <stdlib.h>
119 #endif // HAVE_WCHAR_H
120 #endif // wxUSE_WCHAR_T
121
122 // ----------------------------------------------------------------------------
123 // define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type
124 // mapped to either char or wchar_t depending on the ASCII/Unicode mode and have
125 // the function mapping _tfoo() -> foo() or wfoo()
126 // ----------------------------------------------------------------------------
127
128 // VC++ and BC++ starting with 5.2 have TCHAR support
129 #ifdef __VISUALC__
130 #define wxHAVE_TCHAR_SUPPORT
131 #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
132 #define wxHAVE_TCHAR_SUPPORT
133 #include <ctype.h>
134 #elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 )
135 #define wxHAVE_TCHAR_SUPPORT
136 #include <stddef.h>
137 #include <string.h>
138 #include <ctype.h>
139 #elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
140 // VZ: the old VisualAge definitions were completely wrong and had no
141 // chance at all to work in Unicode build anyhow so let's pretend that
142 // VisualAge does _not_ support TCHAR for the moment (as indicated by
143 // "0 &&" above) until someone really has time to delve into Unicode
144 // issues under OS/2
145
146 // VisualAge 4.0+ supports TCHAR
147 #define wxHAVE_TCHAR_SUPPORT
148 #endif // compilers with (good) TCHAR support
149
150 #ifdef wxHAVE_TCHAR_SUPPORT
151 // get TCHAR definition if we've got it
152 #include <tchar.h>
153
154 // we surely do have wchar_t if we have TCHAR
155 #ifndef wxUSE_WCHAR_T
156 #define wxUSE_WCHAR_T 1
157 #endif // !defined(wxUSE_WCHAR_T)
158
159 // and we also do have wcslen()
160 #ifndef HAVE_WCSLEN
161 #define HAVE_WCSLEN
162 #endif
163 #endif // wxHAVE_TCHAR_SUPPORT
164
165 // ----------------------------------------------------------------------------
166 // define wxChar type
167 // ----------------------------------------------------------------------------
168
169 // TODO: define wxCharInt to be equal to either int or wint_t?
170
171 #if !wxUSE_UNICODE
172 typedef char wxChar;
173 typedef signed char wxSChar;
174 typedef unsigned char wxUChar;
175 #else // Unicode
176 // VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as
177 // signed/unsigned version of it which (a) makes sense to me (unlike
178 // char wchar_t is always unsigned) and (b) was how the previous
179 // definitions worked so keep it like this
180
181 // GNU libc has __WCHAR_TYPE__ which requires special treatment, see
182 // comment below
183 #if !defined(__WCHAR_TYPE__) || \
184 (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
185 // standard case
186 typedef wchar_t wxChar;
187 typedef wchar_t wxSChar;
188 typedef wchar_t wxUChar;
189 #else // __WCHAR_TYPE__ and gcc < 2.96
190 // VS: wxWindows used to define wxChar as __WCHAR_TYPE__ here. However,
191 // this doesn't work with new GCC 3.x compilers because wchar_t is
192 // C++'s builtin type in the new standard. OTOH, old compilers (GCC
193 // 2.x) won't accept new definition of wx{S,U}Char, therefore we
194 // have to define wxChar conditionally depending on detected
195 // compiler & compiler version.
196 // with old definition of wxChar.
197 typedef __WCHAR_TYPE__ wxChar;
198 typedef __WCHAR_TYPE__ wxSChar;
199 typedef __WCHAR_TYPE__ wxUChar;
200 #endif // __WCHAR_TYPE__
201 #endif // ASCII/Unicode
202
203 // ----------------------------------------------------------------------------
204 // define _T() and related macros
205 // ----------------------------------------------------------------------------
206
207 // BSD systems define _T() to be something different in ctype.h, override it
208 #if defined(__FreeBSD__) || defined(__DARWIN__)
209 #include <ctype.h>
210 #undef _T
211 #endif
212
213 // could already be defined by tchar.h (it's quasi standard)
214 #ifndef _T
215 #if !wxUSE_UNICODE
216 #define _T(x) x
217 #else // Unicode
218 #define _T(x) L ## x
219 #endif // ASCII/Unicode
220 #endif // !defined(_T)
221
222 // although global macros with such names are normally bad, we want to have
223 // another name for _T() which should be used to avoid confusion between _T()
224 // and _() in wxWindows sources
225 #define wxT(x) _T(x)
226
227 // Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs
228 #ifndef __TFILE__
229 #define __XFILE__(x) wxT(x)
230 #define __TFILE__ __XFILE__(__FILE__)
231 #endif
232
233 #ifndef __TDATE__
234 #define __XDATE__(x) wxT(x)
235 #define __TDATE__ __XDATE__(__DATE__)
236 #endif
237
238 #ifndef __TTIME__
239 #define __XTIME__(x) wxT(x)
240 #define __TTIME__ __XTIME__(__TIME__)
241 #endif
242
243 // ----------------------------------------------------------------------------
244 // define wxFoo() function for each standard foo() function whose signature
245 // (exceptionally including the return type) includes any mention of char:
246 // wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
247 // the same signature but with char replaced by wxChar which allows us to use
248 // it in Unicode build as well
249 // ----------------------------------------------------------------------------
250
251 #ifdef wxHAVE_TCHAR_SUPPORT
252 #include <ctype.h>
253
254 // ctype.h functions
255 #define wxIsalnum _istalnum
256 #define wxIsalpha _istalpha
257 #define wxIsctrl _istctrl
258 #define wxIsdigit _istdigit
259 #define wxIsgraph _istgraph
260 #define wxIslower _istlower
261 #define wxIsprint _istprint
262 #define wxIspunct _istpunct
263 #define wxIsspace _istspace
264 #define wxIsupper _istupper
265 #define wxIsxdigit _istxdigit
266 #define wxTolower _totlower
267 #define wxToupper _totupper
268
269 // locale.h functons
270 #define wxSetlocale _tsetlocale
271
272 // string.h functions
273 #define wxStrcat _tcscat
274 #define wxStrchr _tcschr
275 #define wxStrcmp _tcscmp
276 #define wxStrcoll _tcscoll
277 #define wxStrcpy _tcscpy
278 #define wxStrcspn _tcscspn
279 #define wxStrdupW _wcsdup // notice the 'W'!
280 #define wxStrftime _tcsftime
281 #define wxStricmp _tcsicmp
282 #define wxStrnicmp _tcsnicmp
283 #define wxStrlen_ _tcslen // used in wxStrlen inline function
284 #define wxStrncat _tcsncat
285 #define wxStrncmp _tcsncmp
286 #define wxStrncpy _tcsncpy
287 #define wxStrpbrk _tcspbrk
288 #define wxStrrchr _tcsrchr
289 #define wxStrspn _tcsspn
290 #define wxStrstr _tcsstr
291 #define wxStrtod _tcstod
292 #define wxStrtol _tcstol
293 #define wxStrtoul _tcstoul
294 #define wxStrxfrm _tcsxfrm
295
296 // stdio.h functions
297 #define wxFgetc _fgettc
298 #define wxFgetchar _fgettchar
299 #define wxFgets _fgetts
300 #define wxFopen _tfopen
301 #define wxFputc _fputtc
302 #define wxFputchar _fputtchar
303 #define wxFprintf _ftprintf
304 #define wxFputs _fputts
305 #define wxFreopen _tfreopen
306 #define wxFscanf _ftscanf
307 #define wxGetc _gettc
308 #define wxGetchar _gettchar
309 #define wxGets _getts
310 #define wxPerror _tperror
311 #define wxPrintf _tprintf
312 #define wxPutc _puttc
313 #define wxPutchar _puttchar
314 #define wxPuts _putts
315 #define wxScanf _tscanf
316 #define wxSprintf _stprintf
317 #define wxSscanf _stscanf
318 #define wxTmpnam _ttmpnam
319 #define wxUngetc _tungetc
320 #define wxVfprintf _vftprintf
321 #define wxVprintf _vtprintf
322 #define wxVsscanf _vstscanf
323 #define wxVsprintf _vstprintf
324
325 // special case: not all TCHAR-aware compilers have those
326 #if defined(__VISUALC__) || \
327 (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
328 #define wxVsnprintf_ _vsntprintf
329 #define wxSnprintf_ _sntprintf
330 #endif
331
332 // special case: these functions are missing under Win9x with Unicows so we
333 // have to implement them ourselves
334 #if wxUSE_UNICODE_MSLU
335 #define wxRemove wxMSLU__tremove
336 #define wxRename wxMSLU__trename
337 #else
338 #define wxRemove _tremove
339 #define wxRename _trename
340 #endif
341
342 // stdlib.h functions
343 #define wxAtoi _ttoi
344 #define wxAtol _ttol
345 // #define wxAtof _tttof -- notice that there is no such thing (why?)
346 #define wxGetenv _tgetenv
347 #define wxSystem _tsystem
348
349 // time.h functions
350 #define wxAsctime _tasctime
351 #define wxCtime _tctime
352 #else // !TCHAR-aware compilers
353 #if wxUSE_UNICODE
354 #include <wctype.h>
355
356 // this is probably glibc-specific
357 #if defined(__WCHAR_TYPE__)
358 // ctype.h functions (wctype.h)
359 #define wxIsalnum iswalnum
360 #define wxIsalpha iswalpha
361 #define wxIsctrl iswcntrl
362 #define wxIsdigit iswdigit
363 #define wxIsgraph iswgraph
364 #define wxIslower iswlower
365 #define wxIsprint iswprint
366 #define wxIspunct iswpunct
367 #define wxIsspace iswspace
368 #define wxIsupper iswupper
369 #define wxIsxdigit iswxdigit
370
371 #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
372 // /usr/include/wctype.h incorrectly declares translations
373 // tables which provokes tons of compile-time warnings -- try
374 // to correct this
375 #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
376 #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
377 #else // !glibc 2.0
378 #define wxTolower towlower
379 #define wxToupper towupper
380 #endif // gcc/!gcc
381
382 // string.h functions (wchar.h)
383 #define wxStrcat wcscat
384 #define wxStrchr wcschr
385 #define wxStrcmp wcscmp
386 #define wxStrcoll wcscoll
387 #define wxStrcpy wcscpy
388 #define wxStrcspn wcscspn
389 #define wxStrlen_ wxWcslen // wxStrlen_() is used in wxStrlen()
390 #define wxStrncat wcsncat
391 #define wxStrncmp wcsncmp
392 #define wxStrncpy wcsncpy
393 #define wxStrpbrk wcspbrk
394 #define wxStrrchr wcsrchr
395 #define wxStrspn wcsspn
396 #define wxStrstr wcsstr
397 #define wxStrtod wcstod
398 #define wxStrtol wcstol
399 #define wxStrtoul wcstoul
400 #define wxStrxfrm wcsxfrm
401
402 #define wxFgetc fgetwc
403 #define wxFgetchar fgetwchar
404 #define wxFgets fgetws
405 #define wxFputc fputwc
406 #define wxFputchar fputwchar
407 #define wxGetc getwc
408 #define wxGetchar getwchar
409 #define wxGets getws
410 #define wxUngetc ungetwc
411
412 #ifdef HAVE_FPUTWC
413 #define wxPutc wputc
414 #define wxPutchar wputchar
415 #define wxPuts putws
416 #define wxFputs fputws
417 #else
418 #define wxNEED_FPUTWC
419
420 #include <stdio.h>
421
422 int wxFputs(const wxChar *ch, FILE *stream);
423 int wxPutc(wxChar ch, FILE *stream);
424
425 #define wxPuts(ws) wxFputs(ws, stdout)
426 #define wxPutchar(wch) wxPutc(wch, stdout)
427 #endif
428
429 // we need %s to %ls conversion for printf and scanf etc
430 #define wxNEED_PRINTF_CONVERSION
431
432 // glibc doesn't have wide char equivalents of the other stuff so
433 // use our own versions
434 #define wxNEED_WX_STDIO_H
435 #define wxNEED_WX_STDLIB_H
436 #define wxNEED_WX_TIME_H
437 #else // !glibc
438 #error "Please define wide character functions for your environment"
439 #endif
440 #else // ASCII
441 #include <ctype.h>
442 #include <string.h>
443
444 // ctype.h functions
445 #define wxIsalnum isalnum
446 #define wxIsalpha isalpha
447 #define wxIsctrl isctrl
448 #define wxIsdigit isdigit
449 #define wxIsgraph isgraph
450 #define wxIslower islower
451 #define wxIsprint isprint
452 #define wxIspunct ispunct
453 #define wxIsspace isspace
454 #define wxIsupper isupper
455 #define wxIsxdigit isxdigit
456 #define wxTolower tolower
457 #define wxToupper toupper
458
459 // locale.h functons
460 #define wxSetlocale setlocale
461
462 // string.h functions
463 #define wxStrcat strcat
464 #define wxStrchr strchr
465 #define wxStrcmp strcmp
466 #define wxStrcoll strcoll
467 #define wxStrcpy strcpy
468 #define wxStrcspn strcspn
469
470 // wxStricmp and wxStrnicmp are defined below
471 #define wxStrlen_ strlen // used in wxStrlen inline function
472 #define wxStrncat strncat
473 #define wxStrncmp strncmp
474 #define wxStrncpy strncpy
475 #define wxStrpbrk strpbrk
476 #define wxStrrchr strrchr
477 #define wxStrspn strspn
478 #define wxStrstr strstr
479 #define wxStrtod strtod
480 #ifdef HAVE_STRTOK_R
481 #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
482 #endif
483 #define wxStrtol strtol
484 #define wxStrtoul strtoul
485 #define wxStrxfrm strxfrm
486
487 // stdio.h functions
488 #define wxFopen fopen
489 #define wxFreopen freopen
490 #define wxPerror perror
491 #define wxRemove remove
492 #define wxRename rename
493 #define wxTmpnam tmpnam
494
495 #define wxFgetc fgetc
496 #define wxFgetchar fgetchar
497 #define wxFgets fgets
498 #define wxFputc fputc
499 #define wxFputchar fputchar
500 #define wxFprintf fprintf
501 #define wxFscanf fscanf
502 #define wxGetc getc
503 #define wxGetchar getchar
504 #define wxGets gets
505 #define wxPrintf printf
506 #define wxPutc putc
507 #define wxPutchar putchar
508 #define wxPuts puts
509 #define wxScanf scanf
510 #define wxSprintf sprintf
511 #define wxSscanf sscanf
512 #define wxUngetc ungetc
513 #define wxVfprintf vfprintf
514 #define wxVprintf vprintf
515 #define wxVsscanf vsscanf
516 #define wxVsprintf vsprintf
517
518 // stdlib.h functions
519 #define wxAtof atof
520 #define wxAtoi atoi
521 #define wxAtol atol
522 #define wxGetenv getenv
523 #define wxSystem system
524
525 // time.h functions
526 #define wxAsctime asctime
527 #define wxCtime ctime
528 #define wxStrftime strftime
529 #endif // Unicode/ASCII
530 #endif // TCHAR-aware compilers/the others
531
532 // ----------------------------------------------------------------------------
533 // various special cases
534 // ----------------------------------------------------------------------------
535
536 // define wxStricmp and wxStrnicmp for various compilers
537 //
538 // note that in Unicode mode we definitely are going to need our own version
539 #if !defined(wxStricmp) && !wxUSE_UNICODE
540 #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
541 defined(__SALFORDC__) || defined(__VISAGECPP__) || \
542 defined(__EMX__) || defined(__DJGPP__)
543 #define wxStricmp stricmp
544 #define wxStrnicmp strnicmp
545 #elif defined(__SC__) || defined(__VISUALC__) || \
546 (defined(__MWERKS__) && defined(__INTEL__))
547 #define wxStricmp _stricmp
548 #define wxStrnicmp _strnicmp
549 #elif defined(__UNIX__) || defined(__GNUWIN32__)
550 #define wxStricmp strcasecmp
551 #define wxStrnicmp strncasecmp
552 // #else -- use wxWindows implementation
553 #endif
554 #endif // !defined(wxStricmp)
555
556 // define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as
557 // it's used in wx/buffer.h -- and also might be used just below by wxStrlen()
558 // when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen)
559 #if wxUSE_WCHAR_T
560 #ifdef HAVE_WCSLEN
561 #define wxWcslen wcslen
562 #else
563 inline size_t wxWcslen(const wchar_t *s)
564 {
565 size_t n = 0;
566 while ( *s++ )
567 n++;
568
569 return n;
570 }
571 #endif
572 #endif // wxUSE_WCHAR_T
573
574 // checks whether the passed in pointer is NULL and if the string is empty
575 inline bool wxIsEmpty(const wxChar *p) { return !p || !*p; }
576
577 // safe version of strlen() (returns 0 if passed NULL pointer)
578 inline size_t wxStrlen(const wxChar *psz) { return psz ? wxStrlen_(psz) : 0; }
579
580 // each of strdup() and wcsdup() may or may not be available but we need both
581 // of them anyhow for wx/buffer.h so we define the missing one(s) in
582 // wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
583 // defined -- if this is somehow not the case in some situations, please
584 // correct that and not the lines here
585 #if wxUSE_UNICODE
586 #define wxStrdup wxStrdupW
587 #else
588 #define wxStrdup wxStrdupA
589 #endif
590
591 WXDLLEXPORT bool wxOKlibc(); // for internal use
592
593 // ----------------------------------------------------------------------------
594 // printf() family saga
595 // ----------------------------------------------------------------------------
596
597 /*
598 First of all, we always want to define safe snprintf() function to be used
599 instead of sprintf(). Some compilers already have it (or rather vsnprintf()
600 which we really need...), otherwise we implement it using our own printf()
601 code.
602
603 We define function with a trailing underscore here because the real one is a
604 wrapper around it as explained below
605 */
606 #ifndef wxVsnprintf_
607 #if wxUSE_UNICODE
608 #if defined(HAVE__VSNWPRINTF)
609 #define wxVsnprintf_ _vsnwprintf
610 /* MinGW?MSVCRT has the wrong vswprintf */
611 #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
612 #define wxVsnprintf_ vswprintf
613 #endif
614 #else // ASCII
615 // all versions of CodeWarrior supported by wxWindows apparently have
616 // vsnprintf()
617 #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__)
618 // assume we have snprintf() too if we have vsnprintf()
619 #define wxVsnprintf_ vsnprintf
620 #define wxSnprintf_ snprintf
621 #endif
622 #endif
623 #endif // wxVsnprintf_ not defined yet
624
625 #ifndef wxSnprintf_
626 // no [v]snprintf(), cook our own
627 WXDLLEXPORT int wxSnprintf_(wxChar *buf, size_t len, const wxChar *format,
628 ...) ATTRIBUTE_PRINTF_3;
629 #endif
630 #ifndef wxVsnprintf_
631 WXDLLEXPORT int wxVsnprintf_(wxChar *buf, size_t len, const wxChar *format,
632 va_list argptr);
633 #endif
634
635 /*
636 In Unicode mode we need to have all standard functions such as wprintf() and
637 so on but not all systems have them so use our own implementations in this
638 case.
639 */
640 #if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
641 #define wxNEED_WPRINTF
642 #endif
643
644 /*
645 More Unicode complications: although both ANSI C and C++ define a number of
646 wide character functions such as wprintf(), not all environments have them.
647 Worse, those which do have different behaviours: under Windows, %s format
648 specifier changes its meaning in Unicode build and expects a Unicode string
649 while under Unix/POSIX it still means an ASCII string even for wprintf() and
650 %ls has to be used for wide strings.
651
652 We choose to always emulate Windows behaviour as more useful for us so even
653 if we have wprintf() we still must wrap it in a non trivial wxPrintf().
654
655 However, if we don't have any vswprintf() at all we don't need to redefine
656 anything as our own wxVsnprintf_() already behaves as needed.
657 */
658 #ifndef wxVsnprintf_
659 #undef wxNEED_PRINTF_CONVERSION
660 #endif
661
662 #if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
663 // we need to implement all wide character printf and scanf functions
664 // either because we don't have them at all or because they don't have the
665 // semantics we need
666
667 #include <stdio.h> // for FILE
668
669 int wxScanf( const wxChar *format, ... ) ATTRIBUTE_PRINTF_1;
670 int wxSscanf( const wxChar *str, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
671 int wxFscanf( FILE *stream, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
672 int wxVsscanf( const wxChar *str, const wxChar *format, va_list ap );
673 int wxPrintf( const wxChar *format, ... ) ATTRIBUTE_PRINTF_1;
674 int wxSprintf( wxChar *str, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
675 int wxFprintf( FILE *stream, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
676 int wxVfprintf( FILE *stream, const wxChar *format, va_list ap );
677 int wxVprintf( const wxChar *format, va_list ap );
678 int wxVsprintf( wxChar *str, const wxChar *format, va_list ap );
679 #endif // wxNEED_PRINTF_CONVERSION
680
681 // these 2 can be simply mapped to the versions with underscore at the end
682 // if we don't have to do the conversion
683 #ifdef wxNEED_PRINTF_CONVERSION
684 int wxSnprintf( wxChar *str, size_t size, const wxChar *format, ... ) ATTRIBUTE_PRINTF_3;
685 int wxVsnprintf( wxChar *str, size_t size, const wxChar *format, va_list ap );
686 #else
687 #define wxSnprintf wxSnprintf_
688 #define wxVsnprintf wxVsnprintf_
689 #endif
690
691 // ----------------------------------------------------------------------------
692 // various functions which might not be available in libc and for which we
693 // provide our own replacements in wxchar.cpp
694 // ----------------------------------------------------------------------------
695
696 // ctype.h functions
697 //
698 // VZ: note that this is never defined currently
699 #ifdef wxNEED_WX_CTYPE_H
700 WXDLLEXPORT int wxIsalnum(wxChar ch);
701 WXDLLEXPORT int wxIsalpha(wxChar ch);
702 WXDLLEXPORT int wxIsctrl(wxChar ch);
703 WXDLLEXPORT int wxIsdigit(wxChar ch);
704 WXDLLEXPORT int wxIsgraph(wxChar ch);
705 WXDLLEXPORT int wxIslower(wxChar ch);
706 WXDLLEXPORT int wxIsprint(wxChar ch);
707 WXDLLEXPORT int wxIspunct(wxChar ch);
708 WXDLLEXPORT int wxIsspace(wxChar ch);
709 WXDLLEXPORT int wxIsupper(wxChar ch);
710 WXDLLEXPORT int wxIsxdigit(wxChar ch);
711 WXDLLEXPORT int wxTolower(wxChar ch);
712 WXDLLEXPORT int wxToupper(wxChar ch);
713 #endif // wxNEED_WX_CTYPE_H
714
715 // under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks
716 // the file parsing -- this may be true for 5.0 as well, update #ifdef then
717 #if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
718 #undef wxIsspace
719 #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
720 #endif // VC++
721
722
723 // string.h functions
724 //
725 // VZ: this is never defined neither currently
726 #ifdef wxNEED_WX_STRING_H
727 WXDLLEXPORT wxChar * wxStrcat(wxChar *dest, const wxChar *src);
728 WXDLLEXPORT const wxChar * wxStrchr(const wxChar *s, wxChar c);
729 WXDLLEXPORT wxChar * wxStrchr(wxChar *s, wxChar c)
730 { return (wxChar *)wxStrchr((const wxChar *)s, c); }
731 WXDLLEXPORT int wxStrcmp(const wxChar *s1, const wxChar *s2);
732 WXDLLEXPORT int wxStrcoll(const wxChar *s1, const wxChar *s2);
733 WXDLLEXPORT wxChar * wxStrcpy(wxChar *dest, const wxChar *src);
734 WXDLLEXPORT size_t wxStrcspn(const wxChar *s, const wxChar *reject);
735 WXDLLEXPORT size_t wxStrlen(const wxChar *s);
736 WXDLLEXPORT wxChar * wxStrncat(wxChar *dest, const wxChar *src, size_t n);
737 WXDLLEXPORT int wxStrncmp(const wxChar *s1, const wxChar *s2, size_t n);
738 WXDLLEXPORT wxChar * wxStrncpy(wxChar *dest, const wxChar *src, size_t n);
739 WXDLLEXPORT const wxChar * wxStrpbrk(const wxChar *s, const wxChar *accept);
740 WXDLLEXPORT wxChar * wxStrpbrk(wxChar *s, const wxChar *accept)
741 { return (wxChar *)wxStrpbrk((const wxChar *)s, accept); }
742 WXDLLEXPORT const wxChar * wxStrrchr(const wxChar *s, wxChar c);
743 WXDLLEXPORT wxChar * wxStrrchr(wxChar *s, wxChar c)
744 { return (wxChar *)wxStrrchr((const wxChar *)s, c); }
745 WXDLLEXPORT size_t wxStrspn(const wxChar *s, const wxChar *accept);
746 WXDLLEXPORT const wxChar * wxStrstr(const wxChar *haystack, const wxChar *needle);
747 WXDLLEXPORT wxChar *wxStrstr(wxChar *haystack, const wxChar *needle)
748 { return (wxChar *)wxStrstr((const wxChar *)haystack, needle); }
749 WXDLLEXPORT double wxStrtod(const wxChar *nptr, wxChar **endptr);
750 WXDLLEXPORT long int wxStrtol(const wxChar *nptr, wxChar **endptr, int base);
751 WXDLLEXPORT unsigned long int wxStrtoul(const wxChar *nptr, wxChar **endptr, int base);
752 WXDLLEXPORT size_t wxStrxfrm(wxChar *dest, const wxChar *src, size_t n);
753 #endif // wxNEED_WX_STRING_H
754
755 #ifndef wxStrdupA
756 WXDLLEXPORT char *wxStrdupA(const char *psz);
757 #endif
758
759 #ifndef wxStrdupW
760 WXDLLEXPORT wchar_t *wxStrdupW(const wchar_t *pwz);
761 #endif
762
763 #ifndef wxStricmp
764 WXDLLEXPORT int wxStricmp(const wxChar *psz1, const wxChar *psz2);
765 #endif
766
767 #ifndef wxStrnicmp
768 WXDLLEXPORT int wxStrnicmp(const wxChar *psz1, const wxChar *psz2, size_t len);
769 #endif
770
771 #ifndef wxStrtok
772 WXDLLEXPORT wxChar * wxStrtok(wxChar *psz, const wxChar *delim, wxChar **save_ptr);
773 #endif
774
775 #ifndef wxSetlocale
776 class WXDLLEXPORT wxWCharBuffer;
777 WXDLLEXPORT wxWCharBuffer wxSetlocale(int category, const wxChar *locale);
778 #endif
779
780 // stdio.h functions
781 #ifdef wxNEED_WX_STDIO_H
782 #include <stdio.h>
783 WXDLLEXPORT FILE * wxFopen(const wxChar *path, const wxChar *mode);
784 WXDLLEXPORT FILE * wxFreopen(const wxChar *path, const wxChar *mode, FILE *stream);
785 WXDLLEXPORT int wxRemove(const wxChar *path);
786 WXDLLEXPORT int wxRename(const wxChar *oldpath, const wxChar *newpath);
787
788 // *printf() family is handled separately
789 #endif // wxNEED_WX_STDIO_H
790
791
792 // stdlib.h functions
793 #ifndef wxAtof
794 WXDLLEXPORT double wxAtof(const wxChar *psz);
795 #endif
796
797 #ifdef wxNEED_WX_STDLIB_H
798 WXDLLEXPORT int wxAtoi(const wxChar *psz);
799 WXDLLEXPORT long wxAtol(const wxChar *psz);
800 WXDLLEXPORT wxChar * wxGetenv(const wxChar *name);
801 WXDLLEXPORT int wxSystem(const wxChar *psz);
802 #endif
803
804
805 // time.h functions
806 #ifdef wxNEED_WX_TIME_H
807 WXDLLEXPORT size_t wxStrftime(wxChar *s, size_t max,
808 const wxChar *fmt, const struct tm *tm);
809 #endif // wxNEED_WX_TIME_H
810
811 // ----------------------------------------------------------------------------
812 // multibyte to wide char conversion functions and macros
813 // ----------------------------------------------------------------------------
814
815 #if wxUSE_WCHAR_T
816 // multibyte<->widechar conversion
817 WXDLLEXPORT size_t wxMB2WC(wchar_t *buf, const char *psz, size_t n);
818 WXDLLEXPORT size_t wxWC2MB(char *buf, const wchar_t *psz, size_t n);
819
820 #if wxUSE_UNICODE
821 #define wxMB2WX wxMB2WC
822 #define wxWX2MB wxWC2MB
823 #define wxWC2WX wxStrncpy
824 #define wxWX2WC wxStrncpy
825 #else
826 #define wxMB2WX wxStrncpy
827 #define wxWX2MB wxStrncpy
828 #define wxWC2WX wxWC2MB
829 #define wxWX2WC wxMB2WC
830 #endif
831 #else // !wxUSE_UNICODE
832 // No wxUSE_WCHAR_T: we have to do something (JACS)
833 #define wxMB2WC wxStrncpy
834 #define wxWC2MB wxStrncpy
835 #define wxMB2WX wxStrncpy
836 #define wxWX2MB wxStrncpy
837 #define wxWC2WX wxWC2MB
838 #define wxWX2WC wxMB2WC
839 #endif
840
841 #endif //_WX_WXCHAR_H_
842