include/wx/wxcrt.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/wxcrt.h
   3 // Purpose:     Type-safe ANSI and Unicode builds compatible wrappers for
   4 //              CRT functions
   5 // Author:      Joel Farley, Ove Kåven
   6 // Modified by: Vadim Zeitlin, Robert Roebling, Ron Lee, Vaclav Slavik
   7 // Created:     1998/06/12
   8 // RCS-ID:      $Id$
   9 // Copyright:   (c) 1998-2006 wxWidgets dev team
  10 // Licence:     wxWindows licence
  11 ///////////////////////////////////////////////////////////////////////////////
  12
  13 #ifndef _WX_WXCRT_H_
  14 #define _WX_WXCRT_H_
  15
  16 // NB: User code should include wx/crt.h instead of including this
  17 //     header directly.
  18
  19 #include "wx/wxcrtbase.h"
  20 #include "wx/string.h"
  21
  22 // ============================================================================
  23 //                              misc functions
  24 // ============================================================================
  25
  26 /* checks whether the passed in pointer is NULL and if the string is empty */
  27 inline bool wxIsEmpty(const char *s) { return !s || !*s; }
  28 inline bool wxIsEmpty(const wchar_t *s) { return !s || !*s; }
  29 inline bool wxIsEmpty(const wxCharBuffer& s) { return wxIsEmpty(s.data()); }
  30 inline bool wxIsEmpty(const wxWCharBuffer& s) { return wxIsEmpty(s.data()); }
  31 inline bool wxIsEmpty(const wxString& s) { return s.empty(); }
  32 inline bool wxIsEmpty(const wxCStrData& s) { return s.AsString().empty(); }
  33
  34
  35 // FIXME-UTF8: get rid of this, it's ANSI only anyway
  36 WXDLLIMPEXP_BASE bool wxOKlibc(); /* for internal use */
  37
  38
  39 /* multibyte to wide char conversion functions and macros */
  40
  41 #if wxUSE_WCHAR_T
  42     /* multibyte<->widechar conversion */
  43     WXDLLIMPEXP_BASE size_t wxMB2WC(wchar_t *buf, const char *psz, size_t n);
  44     WXDLLIMPEXP_BASE size_t wxWC2MB(char *buf, const wchar_t *psz, size_t n);
  45
  46     #if wxUSE_UNICODE
  47         #define wxMB2WX wxMB2WC
  48         #define wxWX2MB wxWC2MB
  49         #define wxWC2WX wxStrncpy
  50         #define wxWX2WC wxStrncpy
  51     #else
  52         #define wxMB2WX wxStrncpy
  53         #define wxWX2MB wxStrncpy
  54         #define wxWC2WX wxWC2MB
  55         #define wxWX2WC wxMB2WC
  56     #endif
  57 #else /* !wxUSE_UNICODE */
  58     /* No wxUSE_WCHAR_T: we have to do something (JACS) */
  59     #define wxMB2WC wxStrncpy
  60     #define wxWC2MB wxStrncpy
  61     #define wxMB2WX wxStrncpy
  62     #define wxWX2MB wxStrncpy
  63     #define wxWC2WX wxWC2MB
  64     #define wxWX2WC wxMB2WC
  65 #endif
  66
  67
  68 //  RN: We could do the usual tricky compiler detection here,
  69 //  and use their variant (such as wmemchr, etc.).  The problem
  70 //  is that these functions are quite rare, even though they are
  71 //  part of the current POSIX standard.  In addition, most compilers
  72 //  (including even MSC) inline them just like we do right in their
  73 //  headers.
  74 //
  75 #if wxUSE_UNICODE
  76     #include <string.h> //for mem funcs
  77
  78     //implement our own wmem variants
  79     inline wxChar* wxTmemchr(const wxChar* s, wxChar c, size_t l)
  80     {
  81         for(;l && *s != c;--l, ++s) {}
  82
  83         if(l)
  84             return (wxChar*)s;
  85         return NULL;
  86     }
  87
  88     inline int wxTmemcmp(const wxChar* sz1, const wxChar* sz2, size_t len)
  89     {
  90         for(; *sz1 == *sz2 && len; --len, ++sz1, ++sz2) {}
  91
  92         if(len)
  93             return *sz1 < *sz2 ? -1 : *sz1 > *sz2;
  94         else
  95             return 0;
  96     }
  97
  98     inline wxChar* wxTmemcpy(wxChar* szOut, const wxChar* szIn, size_t len)
  99     {
 100         return (wxChar*) memcpy(szOut, szIn, len * sizeof(wxChar));
 101     }
 102
 103     inline wxChar* wxTmemmove(wxChar* szOut, const wxChar* szIn, size_t len)
 104     {
 105         return (wxChar*) memmove(szOut, szIn, len * sizeof(wxChar));
 106     }
 107
 108     inline wxChar* wxTmemset(wxChar* szOut, const wxChar cIn, size_t len)
 109     {
 110         wxChar* szRet = szOut;
 111
 112         while (len--)
 113             *szOut++ = cIn;
 114
 115         return szRet;
 116     }
 117
 118     // and trivial wrappers for char* versions:
 119     inline char* wxTmemchr(const char* s, char c, size_t len)
 120         { return (char*)memchr(s, c, len); }
 121     inline int wxTmemcmp(const char* sz1, const char* sz2, size_t len)
 122         { return memcmp(sz1, sz2, len); }
 123     inline char* wxTmemcpy(char* szOut, const char* szIn, size_t len)
 124         { return (char*)memcpy(szOut, szIn, len); }
 125     inline char* wxTmemmove(char* szOut, const char* szIn, size_t len)
 126         { return (char*)memmove(szOut, szIn, len); }
 127     inline char* wxTmemset(char* szOut, const char cIn, size_t len)
 128         { return (char*)memset(szOut, cIn, len); }
 129
 130 #else /* !wxUSE_UNICODE */
 131     #define wxTmemchr memchr
 132     #define wxTmemcmp memcmp
 133     #define wxTmemcpy memcpy
 134     #define wxTmemmove memmove
 135     #define wxTmemset memset
 136 #endif /* wxUSE_UNICODE/!wxUSE_UNICODE */
 137
 138
 139
 140 // ============================================================================
 141 //     wx wrappers for CRT functions in both char* and wchar_t* versions
 142 // ============================================================================
 143
 144 // A few notes on implementation of these wrappers:
 145 //
 146 // We need both char* and wchar_t* versions of functions like wxStrlen() for
 147 // compatibility with both ANSI and Unicode builds.
 148 //
 149 // This makes passing wxString or c_str()/mb_str()/wc_str() result to them
 150 // ambiguous, so we need to provide overrides for that as well (in cases where
 151 // it makes sense).
 152 //
 153 // We can do this without problems for some functions (wxStrlen()), but in some
 154 // cases, we can't stay compatible with both ANSI and Unicode builds, e.g. for
 155 // wxStrcpy(const wxString&), which can only return either char* or wchar_t*.
 156 // In these cases, we preserve ANSI build compatibility by returning char*.
 157
 158 // ----------------------------------------------------------------------------
 159 //                              locale functions
 160 // ----------------------------------------------------------------------------
 161
 162 // NB: we can't provide const wchar_t* (= wxChar*) overload, because calling
 163 //     wxSetlocale(category, NULL) -- which is a common thing to do --would be
 164 //     ambiguous
 165 WXDLLIMPEXP_BASE char* wxSetlocale(int category, const char *locale);
 166 inline char* wxSetlocale(int category, const wxCharBuffer& locale)
 167     { return wxSetlocale(category, locale.data()); }
 168 inline char* wxSetlocale(int category, const wxString& locale)
 169     { return wxSetlocale(category, locale.mb_str()); }
 170 inline char* wxSetlocale(int category, const wxCStrData& locale)
 171     { return wxSetlocale(category, locale.AsCharBuf()); }
 172
 173 // ----------------------------------------------------------------------------
 174 //                              string functions
 175 // ----------------------------------------------------------------------------
 176
 177 /* safe version of strlen() (returns 0 if passed NULL pointer) */
 178 // NB: these are defined in wxcrtbase.h, see the comment there
 179 // inline size_t wxStrlen(const char *s) { return s ? strlen(s) : 0; }
 180 // inline size_t wxStrlen(const wchar_t *s) { return s ? wxCRT_Strlen_(s) : 0; }
 181 inline size_t wxStrlen(const wxCharBuffer& s) { return wxStrlen(s.data()); }
 182 inline size_t wxStrlen(const wxWCharBuffer& s) { return wxStrlen(s.data()); }
 183 inline size_t wxStrlen(const wxString& s) { return s.length(); }
 184 inline size_t wxStrlen(const wxCStrData& s) { return s.AsString().length(); }
 185
 186 // NB: these are defined in wxcrtbase.h, see the comment there
 187 // inline char* wxStrdup(const char *s) { return wxStrdupA(s); }
 188 // inline wchar_t* wxStrdup(const wchar_t *s) { return wxStrdupW(s); }
 189 inline char* wxStrdup(const wxCharBuffer& s) { return wxStrdup(s.data()); }
 190 inline wchar_t* wxStrdup(const wxWCharBuffer& s) { return wxStrdup(s.data()); }
 191 inline char* wxStrdup(const wxString& s) { return wxStrdup(s.mb_str()); }
 192 inline char* wxStrdup(const wxCStrData& s) { return wxStrdup(s.AsCharBuf()); }
 193
 194 inline char *wxStrcpy(char *dest, const char *src)
 195     { return wxCRT_StrcpyA(dest, src); }
 196 inline wchar_t *wxStrcpy(wchar_t *dest, const wchar_t *src)
 197     { return wxCRT_StrcpyW(dest, src); }
 198 inline char *wxStrcpy(char *dest, const wxString& src)
 199     { return wxCRT_StrcpyA(dest, src.mb_str()); }
 200 inline char *wxStrcpy(char *dest, const wxCStrData& src)
 201     { return wxCRT_StrcpyA(dest, src.AsCharBuf()); }
 202 inline char *wxStrcpy(char *dest, const wxCharBuffer& src)
 203     { return wxCRT_StrcpyA(dest, src.data()); }
 204 inline wchar_t *wxStrcpy(wchar_t *dest, const wxString& src)
 205     { return wxCRT_StrcpyW(dest, src.wc_str()); }
 206 inline wchar_t *wxStrcpy(wchar_t *dest, const wxCStrData& src)
 207     { return wxCRT_StrcpyW(dest, src.AsWCharBuf()); }
 208 inline wchar_t *wxStrcpy(wchar_t *dest, const wxWCharBuffer& src)
 209     { return wxCRT_StrcpyW(dest, src.data()); }
 210 inline char *wxStrcpy(char *dest, const wchar_t *src)
 211     { return wxCRT_StrcpyA(dest, wxConvLibc.cWC2MB(src)); }
 212 inline wchar_t *wxStrcpy(wchar_t *dest, const char *src)
 213     { return wxCRT_StrcpyW(dest, wxConvLibc.cMB2WC(src)); }
 214
 215 inline char *wxStrncpy(char *dest, const char *src, size_t n)
 216     { return wxCRT_StrncpyA(dest, src, n); }
 217 inline wchar_t *wxStrncpy(wchar_t *dest, const wchar_t *src, size_t n)
 218     { return wxCRT_StrncpyW(dest, src, n); }
 219 inline char *wxStrncpy(char *dest, const wxString& src, size_t n)
 220     { return wxCRT_StrncpyA(dest, src.mb_str(), n); }
 221 inline char *wxStrncpy(char *dest, const wxCStrData& src, size_t n)
 222     { return wxCRT_StrncpyA(dest, src.AsCharBuf(), n); }
 223 inline char *wxStrncpy(char *dest, const wxCharBuffer& src, size_t n)
 224     { return wxCRT_StrncpyA(dest, src.data(), n); }
 225 inline wchar_t *wxStrncpy(wchar_t *dest, const wxString& src, size_t n)
 226     { return wxCRT_StrncpyW(dest, src.wc_str(), n); }
 227 inline wchar_t *wxStrncpy(wchar_t *dest, const wxCStrData& src, size_t n)
 228     { return wxCRT_StrncpyW(dest, src.AsWCharBuf(), n); }
 229 inline wchar_t *wxStrncpy(wchar_t *dest, const wxWCharBuffer& src, size_t n)
 230     { return wxCRT_StrncpyW(dest, src.data(), n); }
 231 inline char *wxStrncpy(char *dest, const wchar_t *src, size_t n)
 232     { return wxCRT_StrncpyA(dest, wxConvLibc.cWC2MB(src), n); }
 233 inline wchar_t *wxStrncpy(wchar_t *dest, const char *src, size_t n)
 234     { return wxCRT_StrncpyW(dest, wxConvLibc.cMB2WC(src), n); }
 235
 236 inline char *wxStrcat(char *dest, const char *src)
 237     { return wxCRT_StrcatA(dest, src); }
 238 inline wchar_t *wxStrcat(wchar_t *dest, const wchar_t *src)
 239     { return wxCRT_StrcatW(dest, src); }
 240 inline char *wxStrcat(char *dest, const wxString& src)
 241     { return wxCRT_StrcatA(dest, src.mb_str()); }
 242 inline char *wxStrcat(char *dest, const wxCStrData& src)
 243     { return wxCRT_StrcatA(dest, src.AsCharBuf()); }
 244 inline char *wxStrcat(char *dest, const wxCharBuffer& src)
 245     { return wxCRT_StrcatA(dest, src.data()); }
 246 inline wchar_t *wxStrcat(wchar_t *dest, const wxString& src)
 247     { return wxCRT_StrcatW(dest, src.wc_str()); }
 248 inline wchar_t *wxStrcat(wchar_t *dest, const wxCStrData& src)
 249     { return wxCRT_StrcatW(dest, src.AsWCharBuf()); }
 250 inline wchar_t *wxStrcat(wchar_t *dest, const wxWCharBuffer& src)
 251     { return wxCRT_StrcatW(dest, src.data()); }
 252 inline char *wxStrcat(char *dest, const wchar_t *src)
 253     { return wxCRT_StrcatA(dest, wxConvLibc.cWC2MB(src)); }
 254 inline wchar_t *wxStrcat(wchar_t *dest, const char *src)
 255     { return wxCRT_StrcatW(dest, wxConvLibc.cMB2WC(src)); }
 256
 257 inline char *wxStrncat(char *dest, const char *src, size_t n)
 258     { return wxCRT_StrncatA(dest, src, n); }
 259 inline wchar_t *wxStrncat(wchar_t *dest, const wchar_t *src, size_t n)
 260     { return wxCRT_StrncatW(dest, src, n); }
 261 inline char *wxStrncat(char *dest, const wxString& src, size_t n)
 262     { return wxCRT_StrncatA(dest, src.mb_str(), n); }
 263 inline char *wxStrncat(char *dest, const wxCStrData& src, size_t n)
 264     { return wxCRT_StrncatA(dest, src.AsCharBuf(), n); }
 265 inline char *wxStrncat(char *dest, const wxCharBuffer& src, size_t n)
 266     { return wxCRT_StrncatA(dest, src.data(), n); }
 267 inline wchar_t *wxStrncat(wchar_t *dest, const wxString& src, size_t n)
 268     { return wxCRT_StrncatW(dest, src.wc_str(), n); }
 269 inline wchar_t *wxStrncat(wchar_t *dest, const wxCStrData& src, size_t n)
 270     { return wxCRT_StrncatW(dest, src.AsWCharBuf(), n); }
 271 inline wchar_t *wxStrncat(wchar_t *dest, const wxWCharBuffer& src, size_t n)
 272     { return wxCRT_StrncatW(dest, src.data(), n); }
 273 inline char *wxStrncat(char *dest, const wchar_t *src, size_t n)
 274     { return wxCRT_StrncatA(dest, wxConvLibc.cWC2MB(src), n); }
 275 inline wchar_t *wxStrncat(wchar_t *dest, const char *src, size_t n)
 276     { return wxCRT_StrncatW(dest, wxConvLibc.cMB2WC(src), n); }
 277
 278
 279 #define WX_STR_DECL(name, T1, T2)  name(T1 s1, T2 s2)
 280 #define WX_STR_CALL(func, a1, a2)  func(a1, a2)
 281
 282 // This macro defines string function for all possible variants of arguments,
 283 // except for those taking wxString or wxCStrData as second argument.
 284 // Parameters:
 285 //   rettype   - return type
 286 //   name      - name of the (overloaded) function to define
 287 //   crtA      - function to call for char* versions (takes two arguments)
 288 //   crtW      - ditto for wchar_t* function
 289 //   forString - function to call when the *first* argument is wxString;
 290 //               the second argument can be any string type, so this is
 291 //               typically a template
 292 #define WX_STR_FUNC_NO_INVERT(rettype, name, crtA, crtW, forString)           \
 293     inline rettype WX_STR_DECL(name, const char *, const char *)              \
 294         { return WX_STR_CALL(crtA, s1, s2); }                                 \
 295     inline rettype WX_STR_DECL(name, const char *, const wchar_t *)           \
 296         { return WX_STR_CALL(forString, wxString(s1), wxString(s2)); }        \
 297     inline rettype WX_STR_DECL(name, const char *, const wxCharBuffer&)       \
 298         { return WX_STR_CALL(crtA, s1, s2.data()); }                          \
 299     inline rettype WX_STR_DECL(name, const char *, const wxWCharBuffer&)      \
 300         { return WX_STR_CALL(forString, wxString(s1), s2.data()); }           \
 301                                                                               \
 302     inline rettype WX_STR_DECL(name, const wchar_t *, const wchar_t *)        \
 303         { return WX_STR_CALL(crtW, s1, s2); }                                 \
 304     inline rettype WX_STR_DECL(name, const wchar_t *, const char *)           \
 305         { return WX_STR_CALL(forString, wxString(s1), wxString(s2)); }        \
 306     inline rettype WX_STR_DECL(name, const wchar_t *, const wxWCharBuffer&)   \
 307         { return WX_STR_CALL(crtW, s1, s2.data()); }                          \
 308     inline rettype WX_STR_DECL(name, const wchar_t *, const wxCharBuffer&)    \
 309         { return WX_STR_CALL(forString, wxString(s1), s2.data()); }           \
 310                                                                               \
 311     inline rettype WX_STR_DECL(name, const wxCharBuffer&, const char *)       \
 312         { return WX_STR_CALL(crtA, s1.data(), s2); }                          \
 313     inline rettype WX_STR_DECL(name, const wxCharBuffer&, const wchar_t *)    \
 314         { return WX_STR_CALL(forString, wxString(s1), wxString(s2)); }        \
 315     inline rettype WX_STR_DECL(name, const wxCharBuffer&, const wxCharBuffer&)\
 316         { return WX_STR_CALL(crtA, s1.data(), s2.data()); }                   \
 317     inline int WX_STR_DECL(name, const wxCharBuffer&, const wxWCharBuffer&)   \
 318         { return WX_STR_CALL(forString, wxString(s1), wxString(s2)); }        \
 319                                                                               \
 320     inline rettype WX_STR_DECL(name, const wxWCharBuffer&, const wchar_t *)   \
 321         { return WX_STR_CALL(crtW, s1.data(), s2); }                          \
 322     inline rettype WX_STR_DECL(name, const wxWCharBuffer&, const char *)      \
 323         { return WX_STR_CALL(forString, wxString(s1), wxString(s2)); }        \
 324     inline int WX_STR_DECL(name, const wxWCharBuffer&, const wxWCharBuffer&)  \
 325         { return WX_STR_CALL(crtW, s1.data(), s2.data()); }                   \
 326     inline int WX_STR_DECL(name, const wxWCharBuffer&, const wxCharBuffer&)   \
 327         { return WX_STR_CALL(forString, wxString(s1), wxString(s2)); }        \
 328                                                                               \
 329     inline rettype WX_STR_DECL(name, const wxString&, const char*)            \
 330         { return WX_STR_CALL(forString, s1, s2); }                            \
 331     inline rettype WX_STR_DECL(name, const wxString&, const wchar_t*)         \
 332         { return WX_STR_CALL(forString, s1, s2); }                            \
 333     inline rettype WX_STR_DECL(name, const wxString&, const wxCharBuffer&)    \
 334         { return WX_STR_CALL(forString, s1, s2); }                            \
 335     inline rettype WX_STR_DECL(name, const wxString&, const wxWCharBuffer&)   \
 336         { return WX_STR_CALL(forString, s1, s2); }                            \
 337     inline rettype WX_STR_DECL(name, const wxString&, const wxString&)        \
 338         { return WX_STR_CALL(forString, s1, s2); }                            \
 339     inline rettype WX_STR_DECL(name, const wxString&, const wxCStrData&)      \
 340         { return WX_STR_CALL(forString, s1, s2); }                            \
 341                                                                               \
 342     inline rettype WX_STR_DECL(name, const wxCStrData&, const char*)          \
 343         { return WX_STR_CALL(forString, s1.AsString(), s2); }                 \
 344     inline rettype WX_STR_DECL(name, const wxCStrData&, const wchar_t*)       \
 345         { return WX_STR_CALL(forString, s1.AsString(), s2); }                 \
 346     inline rettype WX_STR_DECL(name, const wxCStrData&, const wxCharBuffer&)  \
 347         { return WX_STR_CALL(forString, s1.AsString(), s2); }                 \
 348     inline rettype WX_STR_DECL(name, const wxCStrData&, const wxWCharBuffer&) \
 349         { return WX_STR_CALL(forString, s1.AsString(), s2); }                 \
 350     inline rettype WX_STR_DECL(name, const wxCStrData&, const wxString&)      \
 351         { return WX_STR_CALL(forString, s1.AsString(), s2); }                 \
 352     inline rettype WX_STR_DECL(name, const wxCStrData&, const wxCStrData&)    \
 353         { return WX_STR_CALL(forString, s1.AsString(), s2); }
 354
 355 // This defines strcmp-like function, i.e. one returning the result of
 356 // comparison; see WX_STR_FUNC_NO_INVERT for explanation of the arguments
 357 #define WX_STRCMP_FUNC(name, crtA, crtW, forString)                           \
 358     WX_STR_FUNC_NO_INVERT(int, name, crtA, crtW, forString)                   \
 359                                                                               \
 360     inline int WX_STR_DECL(name, const char *, const wxCStrData&)             \
 361         { return -WX_STR_CALL(forString, s2.AsString(), s1); }                \
 362     inline int WX_STR_DECL(name, const char *, const wxString&)               \
 363         { return -WX_STR_CALL(forString, s2, s1); }                           \
 364                                                                               \
 365     inline int WX_STR_DECL(name, const wchar_t *, const wxCStrData&)          \
 366         { return -WX_STR_CALL(forString, s2.AsString(), s1); }                \
 367     inline int WX_STR_DECL(name, const wchar_t *, const wxString&)            \
 368         { return -WX_STR_CALL(forString, s2, s1); }                           \
 369                                                                               \
 370     inline int WX_STR_DECL(name, const wxCharBuffer&, const wxCStrData&)      \
 371         { return -WX_STR_CALL(forString, s2.AsString(), s1.data()); }         \
 372     inline int WX_STR_DECL(name, const wxCharBuffer&, const wxString&)        \
 373         { return -WX_STR_CALL(forString, s2, s1.data()); }                    \
 374                                                                               \
 375     inline int WX_STR_DECL(name, const wxWCharBuffer&, const wxCStrData&)     \
 376         { return -WX_STR_CALL(forString, s2.AsString(), s1.data()); }         \
 377     inline int WX_STR_DECL(name, const wxWCharBuffer&, const wxString&)       \
 378         { return -WX_STR_CALL(forString, s2, s1.data()); }
 379
 380
 381 // This defines a string function that is *not* strcmp-like, i.e. doesn't
 382 // return the result of comparison and so if the second argument is a string,
 383 // it has to be converted to char* or wchar_t*
 384 #define WX_STR_FUNC(rettype, name, crtA, crtW, forString)                     \
 385     WX_STR_FUNC_NO_INVERT(rettype, name, crtA, crtW, forString)               \
 386                                                                               \
 387     inline rettype WX_STR_DECL(name, const char *, const wxCStrData&)         \
 388         { return WX_STR_CALL(crtA, s1, s2.AsCharBuf()); }                     \
 389     inline rettype WX_STR_DECL(name, const char *, const wxString&)           \
 390         { return WX_STR_CALL(crtA, s1, s2.mb_str()); }                        \
 391                                                                               \
 392     inline rettype WX_STR_DECL(name, const wchar_t *, const wxCStrData&)      \
 393         { return WX_STR_CALL(crtW, s1, s2.AsWCharBuf()); }                    \
 394     inline rettype WX_STR_DECL(name, const wchar_t *, const wxString&)        \
 395         { return WX_STR_CALL(crtW, s1, s2.wc_str()); }                        \
 396                                                                               \
 397     inline rettype WX_STR_DECL(name, const wxCharBuffer&, const wxCStrData&)  \
 398         { return WX_STR_CALL(crtA, s1.data(), s2.AsCharBuf()); }              \
 399     inline rettype WX_STR_DECL(name, const wxCharBuffer&, const wxString&)    \
 400         { return WX_STR_CALL(crtA, s1.data(), s2.mb_str()); }                 \
 401                                                                               \
 402     inline rettype WX_STR_DECL(name, const wxWCharBuffer&, const wxCStrData&) \
 403         { return WX_STR_CALL(crtW, s1.data(), s2.AsWCharBuf()); }             \
 404     inline rettype WX_STR_DECL(name, const wxWCharBuffer&, const wxString&)   \
 405         { return WX_STR_CALL(crtW, s1.data(), s2.wc_str()); }
 406
 407 template<typename T>
 408 inline int wxStrcmp_String(const wxString& s1, const T& s2)
 409     { return s1.compare(s2); }
 410 WX_STRCMP_FUNC(wxStrcmp, wxCRT_StrcmpA, wxCRT_StrcmpW, wxStrcmp_String)
 411
 412 template<typename T>
 413 inline int wxStricmp_String(const wxString& s1, const T& s2)
 414     { return s1.CmpNoCase(s2); }
 415 WX_STRCMP_FUNC(wxStricmp, wxCRT_StricmpA, wxCRT_StricmpW, wxStricmp_String)
 416
 417 template<typename T>
 418 inline int wxStrcoll_String(const wxString& s1, const T& s2)
 419 {
 420 #if wxUSE_UNICODE
 421     // NB: strcoll() doesn't work correctly on UTF-8 strings, so we have to use
 422     //     wc_str() even if wxUSE_UNICODE_UTF8:
 423     return wxStrcoll(s1.wc_str(), s2);
 424 #else
 425     return wxStrcoll(s1.mb_str(), s2);
 426 #endif
 427 }
 428 WX_STRCMP_FUNC(wxStrcoll, wxCRT_StrcollA, wxCRT_StrcollW, wxStrcoll_String)
 429
 430 template<typename T>
 431 inline int wxStrspn_String(const wxString& s1, const T& s2)
 432 {
 433     size_t pos = s1.find_first_not_of(s2);
 434     return (pos == wxString::npos) ? s1.length() : pos;
 435 }
 436 WX_STR_FUNC(size_t, wxStrspn, wxCRT_StrspnA, wxCRT_StrspnW, wxStrspn_String)
 437
 438 template<typename T>
 439 inline int wxStrcspn_String(const wxString& s1, const T& s2)
 440 {
 441     size_t pos = s1.find_first_of(s2);
 442     return (pos == wxString::npos) ? s1.length() : pos;
 443 }
 444 WX_STR_FUNC(size_t, wxStrcspn, wxCRT_StrcspnA, wxCRT_StrcspnW, wxStrcspn_String)
 445
 446 #undef WX_STR_DECL
 447 #undef WX_STR_CALL
 448 #define WX_STR_DECL(name, T1, T2)  name(T1 s1, T2 s2, size_t n)
 449 #define WX_STR_CALL(func, a1, a2)  func(a1, a2, n)
 450
 451 template<typename T>
 452 inline int wxStrncmp_String(const wxString& s1, const T& s2, size_t n)
 453     { return s1.compare(0, n, s2, 0, n); }
 454 WX_STRCMP_FUNC(wxStrncmp, wxCRT_StrncmpA, wxCRT_StrncmpW, wxStrncmp_String)
 455
 456 template<typename T>
 457 inline int wxStrnicmp_String(const wxString& s1, const T& s2, size_t n)
 458     { return s1.substr(0, n).CmpNoCase(wxString(s2).substr(0, n)); }
 459 WX_STRCMP_FUNC(wxStrnicmp, wxCRT_StrnicmpA, wxCRT_StrnicmpW, wxStrnicmp_String)
 460
 461 #undef WX_STR_DECL
 462 #undef WX_STR_CALL
 463 #undef WX_STRCMP_FUNC
 464 #undef WX_STR_FUNC
 465 #undef WX_STR_FUNC_NO_INVERT
 466
 467 inline size_t wxStrxfrm(char *dest, const char *src, size_t n)
 468     { return wxCRT_StrxfrmA(dest, src, n); }
 469 inline size_t wxStrxfrm(wchar_t *dest, const wchar_t *src, size_t n)
 470     { return wxCRT_StrxfrmW(dest, src, n); }
 471 template<typename T>
 472 inline size_t wxStrxfrm(T *dest, const wxCharTypeBuffer<T>& src, size_t n)
 473     { return wxStrxfrm(dest, src.data(), n); }
 474 inline size_t wxStrxfrm(char *dest, const wxString& src, size_t n)
 475     { return wxCRT_StrxfrmA(dest, src.mb_str(), n); }
 476 inline size_t wxStrxfrm(wchar_t *dest, const wxString& src, size_t n)
 477     { return wxCRT_StrxfrmW(dest, src.wc_str(), n); }
 478 inline size_t wxStrxfrm(char *dest, const wxCStrData& src, size_t n)
 479     { return wxCRT_StrxfrmA(dest, src.AsCharBuf(), n); }
 480 inline size_t wxStrxfrm(wchar_t *dest, const wxCStrData& src, size_t n)
 481     { return wxCRT_StrxfrmW(dest, src.AsWCharBuf(), n); }
 482
 483 inline char *wxStrtok(char *str, const char *delim, char **saveptr)
 484     { return wxCRT_StrtokA(str, delim, saveptr); }
 485 inline wchar_t *wxStrtok(wchar_t *str, const wchar_t *delim, wchar_t **saveptr)
 486     { return wxCRT_StrtokW(str, delim, saveptr); }
 487 template<typename T>
 488 inline T *wxStrtok(T *str, const wxCharTypeBuffer<T>& delim, T **saveptr)
 489     { return wxStrtok(str, delim.data(), saveptr); }
 490 inline char *wxStrtok(char *str, const wxCStrData& delim, char **saveptr)
 491     { return wxCRT_StrtokA(str, delim.AsCharBuf(), saveptr); }
 492 inline wchar_t *wxStrtok(wchar_t *str, const wxCStrData& delim, wchar_t **saveptr)
 493     { return wxCRT_StrtokW(str, delim.AsWCharBuf(), saveptr); }
 494 inline char *wxStrtok(char *str, const wxString& delim, char **saveptr)
 495     { return wxCRT_StrtokA(str, delim.mb_str(), saveptr); }
 496 inline wchar_t *wxStrtok(wchar_t *str, const wxString& delim, wchar_t **saveptr)
 497     { return wxCRT_StrtokW(str, delim.wc_str(), saveptr); }
 498
 499 inline const char *wxStrstr(const char *haystack, const char *needle)
 500     { return wxCRT_StrstrA(haystack, needle); }
 501 inline const wchar_t *wxStrstr(const wchar_t *haystack, const wchar_t *needle)
 502     { return wxCRT_StrstrW(haystack, needle); }
 503 inline const char *wxStrstr(const char *haystack, const wxString& needle)
 504     { return wxCRT_StrstrA(haystack, needle.mb_str()); }
 505 inline const wchar_t *wxStrstr(const wchar_t *haystack, const wxString& needle)
 506     { return wxCRT_StrstrW(haystack, needle.wc_str()); }
 507 // these functions return char* pointer into the non-temporary conversion buffer
 508 // used by c_str()'s implicit conversion to char*, for ANSI build compatibility
 509 inline const char *wxStrstr(const wxString& haystack, const wxString& needle)
 510     { return wxCRT_StrstrA(haystack.c_str(), needle.mb_str()); }
 511 inline const char *wxStrstr(const wxCStrData& haystack, const wxString& needle)
 512     { return wxCRT_StrstrA(haystack, needle.mb_str()); }
 513 inline const char *wxStrstr(const wxCStrData& haystack, const wxCStrData& needle)
 514     { return wxCRT_StrstrA(haystack, needle.AsCharBuf()); }
 515 // if 'needle' is char/wchar_t, then the same is probably wanted as return value
 516 inline const char *wxStrstr(const wxString& haystack, const char *needle)
 517     { return wxCRT_StrstrA(haystack.c_str(), needle); }
 518 inline const char *wxStrstr(const wxCStrData& haystack, const char *needle)
 519     { return wxCRT_StrstrA(haystack, needle); }
 520 inline const wchar_t *wxStrstr(const wxString& haystack, const wchar_t *needle)
 521     { return wxCRT_StrstrW(haystack.c_str(), needle); }
 522 inline const wchar_t *wxStrstr(const wxCStrData& haystack, const wchar_t *needle)
 523     { return wxCRT_StrstrW(haystack, needle); }
 524
 525 inline const char *wxStrchr(const char *s, char c)
 526     { return wxCRT_StrchrA(s, c); }
 527 inline const wchar_t *wxStrchr(const wchar_t *s, wchar_t c)
 528     { return wxCRT_StrchrW(s, c); }
 529 inline const char *wxStrrchr(const char *s, char c)
 530     { return wxCRT_StrrchrA(s, c); }
 531 inline const wchar_t *wxStrrchr(const wchar_t *s, wchar_t c)
 532     { return wxCRT_StrrchrW(s, c); }
 533 inline const char *wxStrchr(const char *s, const wxUniChar& c)
 534     { return wxCRT_StrchrA(s, (char)c); }
 535 inline const wchar_t *wxStrchr(const wchar_t *s, const wxUniChar& c)
 536     { return wxCRT_StrchrW(s, (wchar_t)c); }
 537 inline const char *wxStrrchr(const char *s, const wxUniChar& c)
 538     { return wxCRT_StrrchrA(s, (char)c); }
 539 inline const wchar_t *wxStrrchr(const wchar_t *s, const wxUniChar& c)
 540     { return wxCRT_StrrchrW(s, (wchar_t)c); }
 541 inline const char *wxStrchr(const char *s, const wxUniCharRef& c)
 542     { return wxCRT_StrchrA(s, (char)c); }
 543 inline const wchar_t *wxStrchr(const wchar_t *s, const wxUniCharRef& c)
 544     { return wxCRT_StrchrW(s, (wchar_t)c); }
 545 inline const char *wxStrrchr(const char *s, const wxUniCharRef& c)
 546     { return wxCRT_StrrchrA(s, (char)c); }
 547 inline const wchar_t *wxStrrchr(const wchar_t *s, const wxUniCharRef& c)
 548     { return wxCRT_StrrchrW(s, (wchar_t)c); }
 549 template<typename T>
 550 inline const T* wxStrchr(const wxCharTypeBuffer<T>& s, T c)
 551     { return wxStrchr(s.data(), c); }
 552 template<typename T>
 553 inline const T* wxStrrchr(const wxCharTypeBuffer<T>& s, T c)
 554     { return wxStrrchr(s.data(), c); }
 555 template<typename T>
 556 inline const T* wxStrchr(const wxCharTypeBuffer<T>& s, const wxUniChar& c)
 557     { return wxStrchr(s.data(), (T)c); }
 558 template<typename T>
 559 inline const T* wxStrrchr(const wxCharTypeBuffer<T>& s, const wxUniChar& c)
 560     { return wxStrrchr(s.data(), (T)c); }
 561 template<typename T>
 562 inline const T* wxStrchr(const wxCharTypeBuffer<T>& s, const wxUniCharRef& c)
 563     { return wxStrchr(s.data(), (T)c); }
 564 template<typename T>
 565 inline const T* wxStrrchr(const wxCharTypeBuffer<T>& s, const wxUniCharRef& c)
 566     { return wxStrrchr(s.data(), (T)c); }
 567 // these functions return char* pointer into the non-temporary conversion buffer
 568 // used by c_str()'s implicit conversion to char*, for ANSI build compatibility
 569 inline const char* wxStrchr(const wxString& s, char c)
 570     { return wxCRT_StrchrA((const char*)s.c_str(), c); }
 571 inline const char* wxStrrchr(const wxString& s, char c)
 572     { return wxCRT_StrrchrA((const char*)s.c_str(), c); }
 573 inline const char* wxStrchr(const wxString& s, int c)
 574     { return wxCRT_StrchrA((const char*)s.c_str(), c); }
 575 inline const char* wxStrrchr(const wxString& s, int c)
 576     { return wxCRT_StrrchrA((const char*)s.c_str(), c); }
 577 inline const char* wxStrchr(const wxString& s, const wxUniChar& c)
 578     { return wxCRT_StrchrA((const char*)s.c_str(), (char)c); }
 579 inline const char* wxStrrchr(const wxString& s, const wxUniChar& c)
 580     { return wxCRT_StrrchrA((const char*)s.c_str(), (char)c); }
 581 inline const char* wxStrchr(const wxString& s, const wxUniCharRef& c)
 582     { return wxCRT_StrchrA((const char*)s.c_str(), (char)c); }
 583 inline const char* wxStrrchr(const wxString& s, const wxUniCharRef& c)
 584     { return wxCRT_StrrchrA((const char*)s.c_str(), (char)c); }
 585 inline const wchar_t* wxStrchr(const wxString& s, wchar_t c)
 586     { return wxCRT_StrchrW((const wchar_t*)s.c_str(), c); }
 587 inline const wchar_t* wxStrrchr(const wxString& s, wchar_t c)
 588     { return wxCRT_StrrchrW((const wchar_t*)s.c_str(), c); }
 589 inline const char* wxStrchr(const wxCStrData& s, char c)
 590     { return wxCRT_StrchrA(s.AsChar(), c); }
 591 inline const char* wxStrrchr(const wxCStrData& s, char c)
 592     { return wxCRT_StrrchrA(s.AsChar(), c); }
 593 inline const char* wxStrchr(const wxCStrData& s, int c)
 594     { return wxCRT_StrchrA(s.AsChar(), c); }
 595 inline const char* wxStrrchr(const wxCStrData& s, int c)
 596     { return wxCRT_StrrchrA(s.AsChar(), c); }
 597 inline const char* wxStrchr(const wxCStrData& s, const wxUniChar& c)
 598     { return wxCRT_StrchrA(s.AsChar(), (char)c); }
 599 inline const char* wxStrrchr(const wxCStrData& s, const wxUniChar& c)
 600     { return wxCRT_StrrchrA(s.AsChar(), (char)c); }
 601 inline const char* wxStrchr(const wxCStrData& s, const wxUniCharRef& c)
 602     { return wxCRT_StrchrA(s.AsChar(), (char)c); }
 603 inline const char* wxStrrchr(const wxCStrData& s, const wxUniCharRef& c)
 604     { return wxCRT_StrrchrA(s.AsChar(), (char)c); }
 605 inline const wchar_t* wxStrchr(const wxCStrData& s, wchar_t c)
 606     { return wxCRT_StrchrW(s.AsWChar(), c); }
 607 inline const wchar_t* wxStrrchr(const wxCStrData& s, wchar_t c)
 608     { return wxCRT_StrrchrW(s.AsWChar(), c); }
 609
 610 inline const char *wxStrpbrk(const char *s, const char *accept)
 611     { return wxCRT_StrpbrkA(s, accept); }
 612 inline const wchar_t *wxStrpbrk(const wchar_t *s, const wchar_t *accept)
 613     { return wxCRT_StrpbrkW(s, accept); }
 614 inline const char *wxStrpbrk(const char *s, const wxCharBuffer& accept)
 615     { return wxCRT_StrpbrkA(s, accept.data()); }
 616 inline const char *wxStrpbrk(const char *s, const wxString& accept)
 617     { return wxCRT_StrpbrkA(s, accept.mb_str()); }
 618 inline const char *wxStrpbrk(const char *s, const wxCStrData& accept)
 619     { return wxCRT_StrpbrkA(s, accept.AsCharBuf()); }
 620 inline const wchar_t *wxStrpbrk(const wchar_t *s, const wxWCharBuffer& accept)
 621     { return wxCRT_StrpbrkW(s, accept.data()); }
 622 inline const wchar_t *wxStrpbrk(const wchar_t *s, const wxString& accept)
 623     { return wxCRT_StrpbrkW(s, accept.wc_str()); }
 624 inline const wchar_t *wxStrpbrk(const wchar_t *s, const wxCStrData& accept)
 625     { return wxCRT_StrpbrkW(s, accept.AsWCharBuf()); }
 626 inline const char *wxStrpbrk(const wxString& s, const wxString& accept)
 627     { return wxCRT_StrpbrkA(s.c_str(), accept.mb_str()); }
 628 inline const char *wxStrpbrk(const wxCStrData& s, const wxString& accept)
 629     { return wxCRT_StrpbrkA(s.AsChar(), accept.mb_str()); }
 630
 631
 632 /* inlined non-const versions */
 633 inline char *wxStrstr(char *haystack, const char *needle)
 634     { return (char *)wxStrstr((const char *)haystack, needle); }
 635 inline wchar_t *wxStrstr(wchar_t *haystack, const wchar_t *needle)
 636     { return (wchar_t *)wxStrstr((const wchar_t *)haystack, needle); }
 637 inline char *wxStrstr(char *haystack, const wxString& needle)
 638     { return (char *)wxStrstr((const char *)haystack, needle); }
 639 inline wchar_t *wxStrstr(wchar_t *haystack, const wxString& needle)
 640     { return (wchar_t *)wxStrstr((const wchar_t *)haystack, needle); }
 641
 642 inline char * wxStrchr(char *s, char c)
 643     { return (char *)wxStrchr((const char *)s, c); }
 644 inline char * wxStrrchr(char *s, char c)
 645     { return (char *)wxStrrchr((const char *)s, c); }
 646 inline wchar_t * wxStrchr(wchar_t *s, wchar_t c)
 647     { return (wchar_t *)wxStrchr((const wchar_t *)s, c); }
 648 inline wchar_t * wxStrrchr(wchar_t *s, wchar_t c)
 649     { return (wchar_t *)wxStrrchr((const wchar_t *)s, c); }
 650
 651 inline char * wxStrpbrk(char *s, const char *accept)
 652     { return (char *)wxStrpbrk((const char *)s, accept); }
 653 inline wchar_t * wxStrpbrk(wchar_t *s, const wchar_t *accept)
 654     { return (wchar_t *)wxStrpbrk((const wchar_t *)s, accept); }
 655 inline char * wxStrpbrk(char *s, const wxString& accept)
 656     { return (char *)wxStrpbrk((const char *)s, accept); }
 657 inline wchar_t * wxStrpbrk(wchar_t *s, const wxString& accept)
 658     { return (wchar_t *)wxStrpbrk((const wchar_t *)s, accept); }
 659
 660
 661 // ----------------------------------------------------------------------------
 662 //                              stdio.h functions
 663 // ----------------------------------------------------------------------------
 664
 665 // NB: using fn_str() for mode is a hack to get the same type (char*/wchar_t*)
 666 //     as needed, the conversion itself doesn't matter, it's ASCII
 667 inline FILE *wxFopen(const wxString& path, const wxString& mode)
 668     { return wxCRT_Fopen(path.fn_str(), mode.fn_str()); }
 669 inline FILE *wxFreopen(const wxString& path, const wxString& mode, FILE *stream)
 670     { return wxCRT_Freopen(path.fn_str(), mode.fn_str(), stream); }
 671 inline int wxRemove(const wxString& path)
 672     { return wxCRT_Remove(path.fn_str()); }
 673 inline int wxRename(const wxString& oldpath, const wxString& newpath)
 674     { return wxCRT_Rename(oldpath.fn_str(), newpath.fn_str()); }
 675
 676 // NB: we don't provide wxString/wxCStrData versions of wxTmpnam, because 's'
 677 //     is writable
 678 inline char *wxTmpnam(char *s)
 679     { return wxCRT_TmpnamA(s); }
 680 inline wchar_t *wxTmpnam(wchar_t *s)
 681     { return wxCRT_TmpnamW(s); }
 682
 683 extern WXDLLIMPEXP_BASE int wxPuts(const wxString& s);
 684 extern WXDLLIMPEXP_BASE int wxFputs(const wxString& s, FILE *stream);
 685 extern WXDLLIMPEXP_BASE void wxPerror(const wxString& s);
 686
 687 extern WXDLLIMPEXP_BASE int wxFputc(const wxUniChar& c, FILE *stream);
 688
 689 #define wxPutc(c, stream)  wxFputc(c, stream)
 690 #define wxPutchar(c)       wxFputc(c, stdout)
 691 #define wxFputchar(c)      wxPutchar(c)
 692
 693 // NB: We only provide ANSI version of fgets() because fgetws() interprets the
 694 //     stream according to current locale, which is rarely what is desired.
 695 inline char *wxFgets(char *s, int size, FILE *stream)
 696     { return wxCRT_FgetsA(s, size, stream); }
 697 // This version calls ANSI version and converts the string using wxConvLibc
 698 extern WXDLLIMPEXP_BASE wchar_t *wxFgets(wchar_t *s, int size, FILE *stream);
 699
 700 #define wxGets(s) wxGets_is_insecure_and_dangerous_use_wxFgets_instead
 701
 702 // NB: We only provide ANSI versions of this for the same reasons as in the
 703 //     case of wxFgets() above
 704 inline int wxFgetc(FILE *stream) { return wxCRT_FgetcA(stream); }
 705 inline int wxUngetc(int c, FILE *stream) { return wxCRT_UngetcA(c, stream); }
 706
 707 #define wxGetc(stream)     wxFgetc(stream)
 708 #define wxGetchar()        wxFgetc(stdin)
 709 #define wxFgetchar()       wxGetchar()
 710
 711 // ----------------------------------------------------------------------------
 712 //                             stdlib.h functions
 713 // ----------------------------------------------------------------------------
 714
 715 #ifdef wxCRT_AtoiW
 716 inline int wxAtoi(const wxString& str) { return wxCRT_AtoiW(str.wc_str()); }
 717 #else
 718 inline int wxAtoi(const wxString& str) { return wxCRT_AtoiA(str.mb_str()); }
 719 #endif
 720
 721 #ifdef wxCRT_AtolW
 722 inline long wxAtol(const wxString& str) { return wxCRT_AtolW(str.wc_str()); }
 723 #else
 724 inline long wxAtol(const wxString& str) { return wxCRT_AtolA(str.mb_str()); }
 725 #endif
 726
 727 #ifdef wxCRT_AtofW
 728 inline double wxAtof(const wxString& str) { return wxCRT_AtofW(str.wc_str()); }
 729 #else
 730 inline double wxAtof(const wxString& str) { return wxCRT_AtofA(str.mb_str()); }
 731 #endif
 732
 733 inline double wxStrtod(const char *nptr, char **endptr)
 734     { return wxCRT_StrtodA(nptr, endptr); }
 735 inline double wxStrtod(const wchar_t *nptr, wchar_t **endptr)
 736     { return wxCRT_StrtodW(nptr, endptr); }
 737 template<typename T>
 738 inline double wxStrtod(const wxCharTypeBuffer<T>& nptr, T **endptr)
 739     { return wxStrtod(nptr.data(), endptr); }
 740
 741 // We implement wxStrto*() like this so that the code compiles when NULL is
 742 // passed in - - if we had just char** and wchar_t** overloads for 'endptr', it
 743 // would be ambiguous. The solution is to use a template so that endptr can be
 744 // any type: when NULL constant is used, the type will be int and we can handle
 745 // that case specially. Otherwise, we infer the type that 'nptr' should be
 746 // converted to from the type of 'endptr'. We need wxStrtoxCharType<T> template
 747 // to make the code compile even for T=int (that's the case when it's not going
 748 // to be ever used, but it still has to compile).
 749 template<typename T> struct wxStrtoxCharType {};
 750 template<> struct wxStrtoxCharType<char**>
 751     { typedef const char* Type; };
 752 template<> struct wxStrtoxCharType<wchar_t**>
 753     { typedef const wchar_t* Type; };
 754 template<> struct wxStrtoxCharType<int>
 755     { typedef const char* Type; /* this one is never used */ };
 756
 757 template<typename T>
 758 inline double wxStrtod(const wxString& nptr, T endptr)
 759 {
 760     if ( endptr == 0 )
 761     {
 762         // when we don't care about endptr, use the string representation that
 763         // doesn't require any conversion (it doesn't matter for this function
 764         // even if its UTF-8):
 765         return wxStrtod(nptr.wx_str(), (wxStringCharType**)NULL);
 766     }
 767     else
 768     {
 769         // note that it is important to use c_str() here and not mb_str() or
 770         // wc_str(), because we store the pointer into (possibly converted)
 771         // buffer in endptr and so it must be valid even when wxStrtod() returns
 772         return wxStrtod((typename wxStrtoxCharType<T>::Type)nptr.c_str(), endptr);
 773     }
 774 }
 775 template<typename T>
 776 inline double wxStrtod(const wxCStrData& nptr, T endptr)
 777     { return wxStrtod(nptr.AsString(), endptr); }
 778
 779
 780 #define WX_STRTOX_FUNC(rettype, name, implA, implW)                           \
 781     /* see wxStrtod() above for explanation of this code: */                  \
 782     inline rettype name(const char *nptr, char **endptr, int base)            \
 783         { return implA(nptr, endptr, base); }                                 \
 784     inline rettype name(const wchar_t *nptr, wchar_t **endptr, int base)      \
 785         { return implW(nptr, endptr, base); }                                 \
 786     template<typename T>                                                      \
 787     inline rettype name(const wxCharTypeBuffer<T>& nptr, T **endptr, int base)\
 788         { return name(nptr.data(), endptr); }                                 \
 789     template<typename T>                                                      \
 790     inline rettype name(const wxString& nptr, T endptr, int base)             \
 791     {                                                                         \
 792         if ( endptr == 0 )                                                    \
 793             return name(nptr.wx_str(), (wxStringCharType**)NULL, base);       \
 794         else                                                                  \
 795             return name((typename wxStrtoxCharType<T>::Type)nptr.c_str(),     \
 796                         endptr, base);                                        \
 797     }                                                                         \
 798     template<typename T>                                                      \
 799     inline rettype name(const wxCStrData& nptr, T endptr, int base)           \
 800         { return name(nptr.AsString(), endptr, base); }
 801
 802 WX_STRTOX_FUNC(long, wxStrtol, wxCRT_StrtolA, wxCRT_StrtolW)
 803 WX_STRTOX_FUNC(unsigned long, wxStrtoul, wxCRT_StrtoulA, wxCRT_StrtoulW)
 804 WX_STRTOX_FUNC(wxLongLong_t, wxStrtoll, wxCRT_StrtollA, wxCRT_StrtollW)
 805 WX_STRTOX_FUNC(wxULongLong_t, wxStrtoull, wxCRT_StrtoullA, wxCRT_StrtoullW)
 806
 807 #undef WX_STRTOX_FUNC
 808
 809
 810 // mingw32 doesn't provide _tsystem() even though it provides other stdlib.h
 811 // functions in their wide versions
 812 #ifdef wxCRT_SystemW
 813 inline int wxSystem(const wxString& str) { return wxCRT_SystemW(str.wc_str()); }
 814 #else
 815 inline int wxSystem(const wxString& str) { return wxCRT_SystemA(str.mb_str()); }
 816 #endif
 817
 818 inline char* wxGetenv(const char *name) { return wxCRT_GetenvA(name); }
 819 inline wchar_t* wxGetenv(const wchar_t *name) { return wxCRT_GetenvW(name); }
 820 inline char* wxGetenv(const wxString& name) { return wxCRT_GetenvA(name.mb_str()); }
 821 inline char* wxGetenv(const wxCStrData& name) { return wxCRT_GetenvA(name.AsCharBuf()); }
 822 inline char* wxGetenv(const wxCharBuffer& name) { return wxCRT_GetenvA(name.data()); }
 823 inline wchar_t* wxGetenv(const wxWCharBuffer& name) { return wxCRT_GetenvW(name.data()); }
 824
 825
 826 // ----------------------------------------------------------------------------
 827 //                            time.h functions
 828 // ----------------------------------------------------------------------------
 829
 830 inline size_t wxStrftime(char *s, size_t max,
 831                          const wxString& format, const struct tm *tm)
 832     { return wxCRT_StrftimeA(s, max, format.mb_str(), tm); }
 833
 834 inline size_t wxStrftime(wchar_t *s, size_t max,
 835                          const wxString& format, const struct tm *tm)
 836     { return wxCRT_StrftimeW(s, max, format.wc_str(), tm); }
 837
 838 // NB: we can't provide both char* and wchar_t* versions for obvious reasons
 839 //     and returning wxString wouldn't work either (it would be immediately
 840 //     destroyed and if assigned to char*/wchar_t*, the pointer would be
 841 //     invalid), so we only keep ASCII version, because the returned value
 842 //     is always ASCII anyway
 843 #define  wxAsctime   asctime
 844 #define  wxCtime     ctime
 845
 846
 847 // ----------------------------------------------------------------------------
 848 //                             ctype.h functions
 849 // ----------------------------------------------------------------------------
 850
 851 // FIXME-UTF8: we'd be better off implementing these ourselves, as the CRT
 852 //             version is locale-dependent
 853 // FIXME-UTF8: should we return bool from these instead of int?
 854 // FIXME-UTF8: these don't work when EOF is passed in because of wxUniChar,
 855 //             is this OK or not?
 856
 857 inline int wxIsalnum(const wxUniChar& c)  { return wxCRT_IsalnumW(c); }
 858 inline int wxIsalpha(const wxUniChar& c)  { return wxCRT_IsalphaW(c); }
 859 inline int wxIscntrl(const wxUniChar& c)  { return wxCRT_IscntrlW(c); }
 860 inline int wxIsdigit(const wxUniChar& c)  { return wxCRT_IsdigitW(c); }
 861 inline int wxIsgraph(const wxUniChar& c)  { return wxCRT_IsgraphW(c); }
 862 inline int wxIslower(const wxUniChar& c)  { return wxCRT_IslowerW(c); }
 863 inline int wxIsprint(const wxUniChar& c)  { return wxCRT_IsprintW(c); }
 864 inline int wxIspunct(const wxUniChar& c)  { return wxCRT_IspunctW(c); }
 865 inline int wxIsspace(const wxUniChar& c)  { return wxCRT_IsspaceW(c); }
 866 inline int wxIsupper(const wxUniChar& c)  { return wxCRT_IsupperW(c); }
 867 inline int wxIsxdigit(const wxUniChar& c) { return wxCRT_IsxdigitW(c); }
 868
 869 inline wxUniChar wxTolower(const wxUniChar& c) { return wxCRT_TolowerW(c); }
 870 inline wxUniChar wxToupper(const wxUniChar& c) { return wxCRT_ToupperW(c); }
 871
 872 #if WXWIN_COMPATIBILITY_2_8
 873 // we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
 874 // initial versions of this header -- now it is too late to remove it so
 875 // although we fixed the function/macro name above, still provide the
 876 // backwards-compatible synonym.
 877 wxDEPRECATED( inline int wxIsctrl(const wxUniChar& c) );
 878 inline int wxIsctrl(const wxUniChar& c) { return wxIscntrl(c); }
 879 #endif // WXWIN_COMPATIBILITY_2_8
 880
 881 #endif /* _WX_WXCRT_H_ */