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