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