-/////////////////////////////////////////////////////////////////////////////
-// Name: wxchar.h
-// Purpose: Declarations common to wx char/wchar_t usage (wide chars)
-// Author: Joel Farley
-// Modified by:
-// Created: 1998/06/12
-// RCS-ID: $Id$
-// Copyright: (c) wxWindows copyright
-// Licence: wxWindows licence
-/////////////////////////////////////////////////////////////////////////////
+/*
+ * Name: wx/wxchar.h
+ * Purpose: Declarations common to wx char/wchar_t usage (wide chars)
+ * Author: Joel Farley, Ove Kåven
+ * Modified by: Vadim Zeitlin, Robert Roebling, Ron Lee
+ * Created: 1998/06/12
+ * RCS-ID: $Id$
+ * Copyright: (c) 1998-2002 Joel Farley, Ove Kåven, Robert Roebling, Ron Lee
+ * Licence: wxWindows licence
+ */
+
+/* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
#ifndef _WX_WXCHAR_H_
#define _WX_WXCHAR_H_
-#ifdef __GNUG__
-#pragma interface "wxchar.h"
-#endif
+/* defs.h indirectly includes this file, so don't include it here */
+#include "wx/platform.h"
+#include "wx/dlimpexp.h"
-// only do SBCS or _UNICODE
-#if defined (_MBCS )
-#error "MBCS is not supported by wxChar"
+#if defined(HAVE_STRTOK_R) && defined(__DARWIN__) && defined(_MSL_USING_MW_C_HEADERS) && _MSL_USING_MW_C_HEADERS
+ char *strtok_r(char *, const char *, char **);
#endif
-// set wxUSE_UNICODE to 1 if UNICODE or _UNICODE is defined
-#if defined(_UNICODE) || defined(UNICODE)
-#undef wxUSE_UNICODE
-#define wxUSE_UNICODE 1
-#else
-#ifndef wxUSE_UNICODE
-#define wxUSE_UNICODE 0
-#endif
-#endif
+/* check whether we have wchar_t and which size it is if we do */
+#if !defined(wxUSE_WCHAR_T)
+ #if defined(__UNIX__)
+ #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__) || defined(__DARWIN__)
+ #define wxUSE_WCHAR_T 1
+ #else
+ #define wxUSE_WCHAR_T 0
+ #endif
+ #elif defined(__GNUWIN32__) && !defined(__MINGW32__)
+ #define wxUSE_WCHAR_T 0
+ #elif defined(__WATCOMC__)
+ #define wxUSE_WCHAR_T 0
+ #elif defined(__VISAGECPP__) && (__IBMCPP__ < 400)
+ #define wxUSE_WCHAR_T 0
+ #else
+ /* add additional compiler checks if this fails */
+ #define wxUSE_WCHAR_T 1
+ #endif
+#endif /* !defined(wxUSE_WCHAR_T) */
-// and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1...
-#if wxUSE_UNICODE
-#ifndef _UNICODE
-#define _UNICODE
+/* Unicode support requires wchar_t */
+#if wxUSE_UNICODE && !wxUSE_WCHAR_T
+ #error "wchar_t must be available in Unicode build"
+#endif /* Unicode */
+
+/*
+ Standard headers we need here.
+
+ NB: don't include any wxWidgets headers here because almost all of them include
+ this one!
+ */
+
+/* Required for wxPrintf() etc */
+#include <stdarg.h>
+
+/* Almost all compiler have strdup(), but not quite all: CodeWarrior under Mac */
+/* and VC++ for Windows CE don't provide it */
+#if defined(__VISUALC__) && __VISUALC__ >= 1400
+ #define wxStrdupA _strdup
+#elif !(defined(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
+ /* use #define, not inline wrapper, as it is tested with #ifndef below */
+ #define wxStrdupA strdup
#endif
-#ifndef UNICODE
-#define UNICODE
+
+/*
+ non Unix compilers which do have wchar.h (but not tchar.h which is included
+ below and which includes wchar.h anyhow).
+
+ Actually MinGW has tchar.h, but it does not include wchar.h
+ */
+#if defined(__MWERKS__) || defined(__VISAGECPP__) || defined(__MINGW32__) || defined(__WATCOMC__)
+ #ifndef HAVE_WCHAR_H
+ #define HAVE_WCHAR_H
+ #endif
#endif
+#if defined(__MWERKS__) && !defined(__MACH__)
+ #ifndef HAVE_WCSLEN
+ #define HAVE_WCSLEN
+ #endif
#endif
-// Windows (VC++) has broad TCHAR support
-#if defined(__VISUALC__) && defined(__WIN32__)
+#if wxUSE_WCHAR_T
+ #ifdef HAVE_WCHAR_H
+ /* the current (as of Nov 2002) version of cygwin has a bug in its */
+ /* wchar.h -- there is no extern "C" around the declarations in it and */
+ /* this results in linking errors later; also, at least on some */
+ /* Cygwin versions, wchar.h requires sys/types.h */
+ #ifdef __CYGWIN__
+ #include <sys/types.h>
+ #ifdef __cplusplus
+ extern "C" {
+ #endif
+ #endif /* Cygwin */
+
+ #include <wchar.h>
+
+ #if defined(__CYGWIN__) && defined(__cplusplus)
+ }
+ #endif /* Cygwin and C++ */
+
+ #elif defined(HAVE_WCSTR_H)
+ /* old compilers have relevant declarations here */
+ #include <wcstr.h>
+ #elif defined(__FreeBSD__) || defined(__DARWIN__) || defined(__EMX__)
+ /* include stdlib.h for wchar_t */
+ #include <stdlib.h>
+ #endif /* HAVE_WCHAR_H */
+#endif /* wxUSE_WCHAR_T */
+
+/* ---------------------------------------------------------------------------- */
+/* define wxHAVE_TCHAR_SUPPORT for the compilers which support the TCHAR type */
+/* mapped to either char or wchar_t depending on the ASCII/Unicode mode and have */
+/* the function mapping _tfoo() -> foo() or wfoo() */
+/* ---------------------------------------------------------------------------- */
+
+/* VC++ and BC++ starting with 5.2 have TCHAR support */
+#ifdef __VISUALC__
+ #define wxHAVE_TCHAR_SUPPORT
+#elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520)
+ #define wxHAVE_TCHAR_SUPPORT
+ #include <ctype.h>
+#elif defined(__WATCOMC__)
+ #define wxHAVE_TCHAR_SUPPORT
+#elif defined(__DMC__)
+ #define wxHAVE_TCHAR_SUPPORT
+#elif defined(__WXPALMOS__)
+ #include <stddef.h>
+#elif defined(__MINGW32__) && wxCHECK_W32API_VERSION( 1, 0 )
+ #define wxHAVE_TCHAR_SUPPORT
+ #include <stddef.h>
+ #include <string.h>
+ #include <ctype.h>
+#elif 0 && defined(__VISAGECPP__) && (__IBMCPP__ >= 400)
+ /* VZ: the old VisualAge definitions were completely wrong and had no */
+ /* chance at all to work in Unicode build anyhow so let's pretend that */
+ /* VisualAge does _not_ support TCHAR for the moment (as indicated by */
+ /* "0 &&" above) until someone really has time to delve into Unicode */
+ /* issues under OS/2 */
+
+ /* VisualAge 4.0+ supports TCHAR */
+ #define wxHAVE_TCHAR_SUPPORT
+#endif /* compilers with (good) TCHAR support */
+
+#if defined(__MWERKS__)
+ /* Metrowerks only has wide char support for OS X >= 10.3 */
+ #if !defined(__DARWIN__) || \
+ (MAC_OS_X_VERSION_MAX_ALLOWED >= MAC_OS_X_VERSION_10_3)
+ #define wxHAVE_MWERKS_UNICODE
+ #endif
+
+ #ifdef wxHAVE_MWERKS_UNICODE
+ #define HAVE_WPRINTF
+ #endif
+#endif /* __MWERKS__ */
+
+#ifdef wxHAVE_TCHAR_SUPPORT
+ /* get TCHAR definition if we've got it */
+ #include <tchar.h>
+
+ /* we surely do have wchar_t if we have TCHAR */
+ #ifndef wxUSE_WCHAR_T
+ #define wxUSE_WCHAR_T 1
+ #endif /* !defined(wxUSE_WCHAR_T) */
+
+ /* and we also do have wcslen() */
+ #ifndef HAVE_WCSLEN
+ #define HAVE_WCSLEN
+ #endif
+#endif /* wxHAVE_TCHAR_SUPPORT */
+
+/* ---------------------------------------------------------------------------- */
+/* define wxChar type */
+/* ---------------------------------------------------------------------------- */
+
+/* TODO: define wxCharInt to be equal to either int or wint_t? */
-#include <tchar.h>
-#if wxUSE_UNICODE // temporary - preserve binary compatibility
-typedef _TCHAR wxChar;
-typedef _TSCHAR wxSChar;
-typedef _TUCHAR wxUChar;
-#else
-#define wxChar char
-#define wxSChar signed char
-#define wxUChar unsigned char
-#endif
- // wchar_t is available
-#undef wxUSE_WCHAR_T
-#define wxUSE_WCHAR_T 1
-
- // ctype.h functions
-#define wxIsalnum _istalnum
-#define wxIsalpha _istalpha
-#define wxIsctrl _istctrl
-#define wxIsdigit _istdigit
-#define wxIsgraph _istgraph
-#define wxIslower _istlower
-#define wxIsprint _istprint
-#define wxIspunct _istpunct
-#define wxIsspace _istspace
-#define wxIsupper _istupper
-#define wxIsxdigit _istxdigit
-#define wxTolower _totlower
-#define wxToupper _totupper
-
- // locale.h functons
-#define wxSetlocale _tsetlocale
-
- // string.h functions
-#define wxStrcat _tcscat
-#define wxStrchr _tcschr
-#define wxStrcmp _tcscmp
-#define wxStrcoll _tcscoll
-#define wxStrcpy _tcscpy
-#define wxStrcspn _tcscspn
-#define wxStrftime _tcsftime
-#define wxStricmp _tcsicmp
-#define wxStrlen_ _tcslen // used in wxStrlen inline function
-#define wxStrncat _tcsncat
-#define wxStrncmp _tcsncmp
-#define wxStrncpy _tcsncpy
-#define wxStrpbrk _tcspbrk
-#define wxStrrchr _tcsrchr
-#define wxStrspn _tcsspn
-#define wxStrstr _tcsstr
-#define wxStrtod _tcstod
-// is there a _tcstok[_r] ?
-#define wxStrtol _tcstol
-#define wxStrtoul _tcstoul
-#define wxStrxfrm _tcsxfrm
-
- // stdio.h functions
-#define wxFgetc _fgettc
-#define wxFgetchar _fgettchar
-#define wxFgets _fgetts
-#define wxFopen _tfopen
-#define wxFputc _fputtc
-#define wxFputchar _fputtchar
-#define wxFprintf _ftprintf
-#define wxFreopen _tfreopen
-#define wxFscanf _ftscanf
-#define wxGetc _gettc
-#define wxGetchar _gettchar
-#define wxGets _getts
-#define wxPerror _tperror
-#define wxPrintf _tprintf
-#define wxPutc _puttc
-#define wxPutchar _puttchar
-#define wxPuts _putts
-#define wxRemove _tremove
-#define wxRename _trename
-#define wxScanf _tscanf
-#define wxSprintf _stprintf
-#define wxSscanf _stscanf
-#define wxTmpnam _ttmpnam
-#define wxUngetc _tungetc
-#define wxVfprint _vftprintf
-#define wxVprintf _vtprintf
-#define wxVsscanf _vstscanf
-#define wxVsprintf _vstprintf
-
- // stdlib.h functions
#if !wxUSE_UNICODE
-#define wxAtof atof
+ typedef char wxChar;
+ typedef signed char wxSChar;
+ typedef unsigned char wxUChar;
+#else /* Unicode */
+ /* VZ: note that VC++ defines _T[SU]CHAR simply as wchar_t and not as */
+ /* signed/unsigned version of it which (a) makes sense to me (unlike */
+ /* char wchar_t is always unsigned) and (b) was how the previous */
+ /* definitions worked so keep it like this */
+
+ /* Sun's SunPro compiler supports the wchar_t type and wide character */
+ /* functions, but does not define __WCHAR_TYPE__. Define it here to */
+ /* allow unicode enabled builds. */
+ #if defined(__SUNPRO_CC) || defined(__SUNPRO_C)
+ #define __WCHAR_TYPE__ wxchar_t
+ #endif
+
+ /* GNU libc has __WCHAR_TYPE__ which requires special treatment, see */
+ /* comment below */
+ #if !defined(__WCHAR_TYPE__) || \
+ (!defined(__GNUC__) || wxCHECK_GCC_VERSION(2, 96))
+ /* standard case */
+ typedef wchar_t wxChar;
+ typedef wchar_t wxSChar;
+ typedef wchar_t wxUChar;
+ #else /* __WCHAR_TYPE__ and gcc < 2.96 */
+ /* VS: wxWidgets used to define wxChar as __WCHAR_TYPE__ here. However, */
+ /* this doesn't work with new GCC 3.x compilers because wchar_t is */
+ /* C++'s builtin type in the new standard. OTOH, old compilers (GCC */
+ /* 2.x) won't accept new definition of wx{S,U}Char, therefore we */
+ /* have to define wxChar conditionally depending on detected */
+ /* compiler & compiler version. */
+ /* with old definition of wxChar. */
+ typedef __WCHAR_TYPE__ wxChar;
+ typedef __WCHAR_TYPE__ wxSChar;
+ typedef __WCHAR_TYPE__ wxUChar;
+ #endif /* __WCHAR_TYPE__ */
+#endif /* ASCII/Unicode */
+
+/* ---------------------------------------------------------------------------- */
+/* define _T() and related macros */
+/* ---------------------------------------------------------------------------- */
+
+/* BSD systems define _T() to be something different in ctype.h, override it */
+#if defined(__FreeBSD__) || defined(__DARWIN__)
+ #include <ctype.h>
+ #undef _T
#endif
-#define wxAtoi _ttoi
-#define wxAtol _ttol
-#define wxGetenv _tgetenv
-#define wxSystem _tsystem
- // time.h functions
-#define wxAsctime _tasctime
-#define wxCtime _tctime
+/* could already be defined by tchar.h (it's quasi standard) */
+#ifndef _T
+ #if !wxUSE_UNICODE
+ #define _T(x) x
+ #else /* Unicode */
+ /* use wxCONCAT_HELPER so that x could be expanded if it's a macro */
+ #define _T(x) wxCONCAT_HELPER(L, x)
+ #endif /* ASCII/Unicode */
+#endif /* !defined(_T) */
-// #elif defined(XXX)
- // #include XXX-specific files here
- // typeddef YYY wxChar;
+/* although global macros with such names are normally bad, we want to have */
+/* another name for _T() which should be used to avoid confusion between _T() */
+/* and _() in wxWidgets sources */
+#define wxT(x) _T(x)
- // translate wxZZZ names
+/* a helper macro allowing to make another macro Unicode-friendly, see below */
+#define wxAPPLY_T(x) _T(x)
-#elif defined(__BORLANDC__) && defined(__WIN32__)
+/* Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs */
+#ifndef __TFILE__
+ #define __TFILE__ wxAPPLY_T(__FILE__)
+#endif
-// Borland C++ 4.52 doesn't have much tchar support
-// maybe Borland C++ 5.02 has, can't check right now
-// but I'll use the Win32 API instead here
+#ifndef __TDATE__
+ #define __TDATE__ wxAPPLY_T(__DATE__)
+#endif
-#include <tchar.h>
-#if wxUSE_UNICODE // temporary - preserve binary compatibility
-typedef _TCHAR wxChar;
-typedef _TSCHAR wxSChar;
-typedef _TUCHAR wxUChar;
-#else
-#define wxChar char
-#define wxSChar signed char
-#define wxUChar unsigned char
+#ifndef __TTIME__
+ #define __TTIME__ wxAPPLY_T(__TIME__)
#endif
- // wchar_t is available
-#undef wxUSE_WCHAR_T
-#define wxUSE_WCHAR_T 1
-#define wxNEED_WX_CTYPE_H
-// #define wxStrtok strtok_r // Borland C++ 4.52 doesn't have strtok_r
-#define wxNEED_WX_STRING_H
-#define wxNEED_WX_STDIO_H
-#define wxNEED_WX_STDLIB_H
-#define wxNEED_WX_TIME_H
-#define wxNEED_WCSLEN
+/*
+ define wxFoo() function for each standard foo() function whose signature
+ (exceptionally including the return type) includes any mention of char:
+ wxFoo() is going to be a Unicode-friendly version of foo(), i.e. will have
+ the same signature but with char replaced by wxChar which allows us to use
+ it in Unicode build as well
+ */
-#else//!TCHAR-aware compilers
+#ifdef wxHAVE_TCHAR_SUPPORT
+ #include <ctype.h>
-// check whether we should include wchar.h or equivalent
-#if wxUSE_UNICODE
- #undef wxUSE_WCHAR_T
- #define wxUSE_WCHAR_T 1 // wchar_t *must* be available in Unicode mode
-#elif !defined(wxUSE_WCHAR_T)
- #if defined(__VISUALC__) && (__VISUALC__ < 900)
- #define wxUSE_WCHAR_T 0 // wchar_t is not available for MSVC++ 1.5
- #elif defined(__UNIX__)
- #if defined(HAVE_WCSTR_H) || defined(HAVE_WCHAR_H) || defined(__FreeBSD__)
- #define wxUSE_WCHAR_T 1
- #else
- #define wxUSE_WCHAR_T 0
- #endif
- #elif defined(__GNUWIN32__) && !defined(__MINGW32__) // Cygwin (not Mingw32) doesn't have wcslen.h, needed in buffer.h
- #define wxUSE_WCHAR_T 0
- #else
- // add additional compiler checks if this fails
- #define wxUSE_WCHAR_T 1
- #endif
-#endif//wxUSE_UNICODE
+ #if defined(__WATCOMC__) && defined(UNICODE)
+ #define WXWCHAR_T_CAST(c) (wint_t)(c)
+ #else
+ #define WXWCHAR_T_CAST(c) c
+ #endif
-#if wxUSE_WCHAR_T
- #ifdef HAVE_WCSTR_H
- #include <wcstr.h>
- #else
- #ifndef __FreeBSD__
- #include <wchar.h>
- #else
- #include <stdlib.h>
- #define wxNEED_WCSLEN
- #endif
- #endif
-#endif
-
-// check whether we are doing Unicode
-#if wxUSE_UNICODE
+ /* ctype.h functions */
+ #define wxIsalnum(c) _istalnum(WXWCHAR_T_CAST(c))
+ #define wxIsalpha(c) _istalpha(WXWCHAR_T_CAST(c))
+ #define wxIscntrl(c) _istcntrl(WXWCHAR_T_CAST(c))
+ #define wxIsdigit(c) _istdigit(WXWCHAR_T_CAST(c))
+ #define wxIsgraph(c) _istgraph(WXWCHAR_T_CAST(c))
+ #define wxIslower(c) _istlower(WXWCHAR_T_CAST(c))
+ #define wxIsprint(c) _istprint(WXWCHAR_T_CAST(c))
+ #define wxIspunct(c) _istpunct(WXWCHAR_T_CAST(c))
+ #define wxIsspace(c) _istspace(WXWCHAR_T_CAST(c))
+ #define wxIsupper(c) _istupper(WXWCHAR_T_CAST(c))
+ #define wxIsxdigit(c) _istxdigit(WXWCHAR_T_CAST(c))
-#include <wctype.h>
-
-// this is probably glibc-specific
-#if defined(__WCHAR_TYPE__)
-
-typedef __WCHAR_TYPE__ wxChar;
-typedef signed __WCHAR_TYPE__ wxSChar;
-typedef unsigned __WCHAR_TYPE__ wxUChar;
-
-#define _T(x) L##x
-
- // ctype.h functions (wctype.h)
-#define wxIsalnum iswalnum
-#define wxIsalpha iswalpha
-#define wxIsctrl iswcntrl
-#define wxIsdigit iswdigit
-#define wxIsgraph iswgraph
-#define wxIslower iswlower
-#define wxIsprint iswprint
-#define wxIspunct iswpunct
-#define wxIsspace iswspace
-#define wxIsupper iswupper
-#define wxIsxdigit iswxdigit
-
-#if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
- // /usr/include/wctype.h incorrectly declares translations tables which
- // provokes tons of compile-time warnings - try to correct this
- #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
- #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
-#else
- #define wxTolower towlower
- #define wxToupper towupper
-#endif // gcc/!gcc
-
- // string.h functions (wchar.h)
-#define wxStrcat wcscat
-#define wxStrchr wcschr
-#define wxStrcmp wcscmp
-#define wxStrcoll wcscoll
-#define wxStrcpy wcscpy
-#define wxStrcspn wcscspn
-#define wxStrlen_ wcslen // used in wxStrlen inline function
-#define wxStrncat wcsncat
-#define wxStrncmp wcsncmp
-#define wxStrncpy wcsncpy
-#define wxStrpbrk wcspbrk
-#define wxStrrchr wcsrchr
-#define wxStrspn wcsspn
-#define wxStrstr wcsstr
-#define wxStrtod wcstod
-#define wxStrtok wcstok
-#define wxStrtol wcstol
-#define wxStrtoul wcstoul
-#define wxStrxfrm wcsxfrm
-
-// glibc doesn't have wc equivalents of the other stuff
-#define wxNEED_WX_STDIO_H
-#define wxNEED_WX_STDLIB_H
-#define wxNEED_WX_TIME_H
-
-#else//!glibc
-#error "Please define your compiler's Unicode conventions in wxChar.h"
-#endif
-#else//!Unicode
-
-#include <ctype.h>
-#include <string.h>
-
-#if 0 // temporary - preserve binary compatibilty
-typedef char wxChar;
-typedef signed char wxSChar;
-typedef unsigned char wxUChar;
-#else
-#define wxChar char
-#define wxSChar signed char
-#define wxUChar unsigned char
-#endif
-
-#ifdef __FreeBSD__
- #undef _T
-#endif
-#define _T(x) x
-
- // ctype.h functions
-#define wxIsalnum isalnum
-#define wxIsalpha isalpha
-#define wxIsctrl isctrl
-#define wxIsdigit isdigit
-#define wxIsgraph isgraph
-#define wxIslower islower
-#define wxIsprint isprint
-#define wxIspunct ispunct
-#define wxIsspace isspace
-#define wxIsupper isupper
-#define wxIsxdigit isxdigit
-#define wxTolower tolower
-#define wxToupper toupper
-
- // locale.h functons
-#define wxSetlocale setlocale
-
- // string.h functions
-#define wxStricmp strcasecmp
-// #define wxStrtok strtok_r // this needs a configure check
-
- // leave the rest to defaults below
-#define wxNEED_WX_STRING_H
-#define wxNEED_WX_STDIO_H
-#define wxNEED_WX_STDLIB_H
-#define wxNEED_WX_TIME_H
-
-#endif//Unicode
-#endif//TCHAR-aware compilers
-
-// define wxStricmp for various compilers without Unicode possibilities
+ /*
+ There is a bug in VC6 C RTL: toxxx() functions dosn't do anything with
+ signed chars < 0, so "fix" it here.
+ */
+ #define wxTolower(c) _totlower((wxUChar)(c))
+ #define wxToupper(c) _totupper((wxUChar)(c))
+
+ /* locale.h functons */
+ #define wxSetlocale _tsetlocale
+
+ /* string.h functions */
+ #define wxStrcat _tcscat
+ #define wxStrchr _tcschr
+ #define wxStrcmp _tcscmp
+ #define wxStrcoll _tcscoll
+ #define wxStrcpy _tcscpy
+ #define wxStrcspn _tcscspn
+ #define wxStrdupW _wcsdup /* notice the 'W'! */
+ #define wxStrftime _tcsftime
+ #define wxStricmp _tcsicmp
+ #define wxStrnicmp _tcsnicmp
+ #define wxStrlen_ _tcslen /* used in wxStrlen inline function */
+ #define wxStrncat _tcsncat
+ #define wxStrncmp _tcsncmp
+ #define wxStrncpy _tcsncpy
+ #define wxStrpbrk _tcspbrk
+ #define wxStrrchr _tcsrchr
+ #define wxStrspn _tcsspn
+ #define wxStrstr _tcsstr
+ #define wxStrtod _tcstod
+ #define wxStrtol _tcstol
+ #define wxStrtoul _tcstoul
+ #define wxStrxfrm _tcsxfrm
+
+ /* stdio.h functions */
+ #define wxFgetc _fgettc
+ #define wxFgetchar _fgettchar
+ #define wxFgets _fgetts
+ #if wxUSE_UNICODE_MSLU
+ #define wxFopen wxMSLU__tfopen
+ #else
+ #define wxFopen _tfopen
+ #endif
+ #define wxFputc _fputtc
+ #define wxFputchar _fputtchar
+ #define wxFprintf _ftprintf
+ #define wxFputs _fputts
+ #define wxFreopen _tfreopen
+ #define wxFscanf _ftscanf
+ #define wxGetc _gettc
+ #define wxGetchar _gettchar
+ #define wxGets _getts
+ #define wxPerror _tperror
+ #define wxPrintf _tprintf
+ #define wxPutc(c,f) _puttc(WXWCHAR_T_CAST(c),f)
+ #define wxPutchar _puttchar
+ #define wxPuts _putts
+ #define wxScanf _tscanf
+ #if defined(__DMC__)
+ #if wxUSE_UNICODE
+ /* Digital Mars adds count to _stprintf (C99) so prototype conversion see wxchar.cpp */
+ int wxSprintf (wchar_t * __RESTRICT s, const wchar_t * __RESTRICT format, ... ) ;
+ #else
+ /* and there is a bug in D Mars tchar.h prior to 8.39.4n, so define as sprintf */
+ #define wxSprintf sprintf
+ #endif
+ #else
+ #define wxSprintf _stprintf
+ #endif
+
+ #define wxSscanf _stscanf
+ #define wxTmpnam _ttmpnam
+ #define wxUngetc _tungetc
+ #define wxVfprintf _vftprintf
+ #define wxVprintf _vtprintf
+ #define wxVsscanf _vstscanf
+ #define wxVsprintf _vstprintf
+
+ /* special case: not all TCHAR-aware compilers have those */
+ #if defined(__VISUALC__) || \
+ (defined(__BORLANDC__) && __BORLANDC__ >= 0x540)
+ #define wxVsnprintf_ _vsntprintf
+ #define wxSnprintf_ _sntprintf
+ #endif
+
+ /* special case: these functions are missing under Win9x with Unicows so we */
+ /* have to implement them ourselves */
+ #if wxUSE_UNICODE_MSLU
+ #define wxRemove wxMSLU__tremove
+ #define wxRename wxMSLU__trename
+ #else
+ #ifdef __WXWINCE__
+ /* carefully: wxRemove() must return 0 on success while DeleteFile()
+ returns 0 on error, so don't just define one as the other */
+ int wxRemove(const wxChar *path);
+ #else
+ #define wxRemove _tremove
+ #define wxRename _trename
+ #endif
+ #endif
+
+ /* stdlib.h functions */
+ #define wxAtoi _ttoi
+ #define wxAtol _ttol
+ /* #define wxAtof _tttof -- notice that there is no such thing (why?) */
+ /* there are no env vars at all under CE, so no _tgetenv neither */
+ #ifdef __WXWINCE__
+ /* can't define as inline function as this is a C file... */
+ #define wxGetenv(name) ((wxChar *)NULL)
+ #else
+ #define wxGetenv _tgetenv
+ #endif
+ #define wxSystem _tsystem
+
+ /* time.h functions */
+ #define wxAsctime _tasctime
+ #define wxCtime _tctime
+
+ #define wxMbstowcs mbstowcs
+ #define wxWcstombs wcstombs
+#else /* !TCHAR-aware compilers */
+ /*
+ There are 2 unrelated problems with these functions under Mac:
+ a) Metrowerks MSL CRT implements them strictly in C99 sense and
+ doesn't support (very common) extension of allowing to call
+ mbstowcs(NULL, ...) which makes it pretty useless as you can't
+ know the size of the needed buffer
+ b) OS X <= 10.2 declares and even defined these functions but
+ doesn't really implement them -- they always return an error
+
+ So use our own replacements in both cases.
+ */
+ #if defined(__MWERKS__) && defined(__MSL__)
+ #define wxNEED_WX_MBSTOWCS
+ #endif
+
+ #ifdef __DARWIN__
+ #if MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2
+ #define wxNEED_WX_MBSTOWCS
+ #endif
+ #endif
+
+ #ifdef wxNEED_WX_MBSTOWCS
+ /* even though they are defined and "implemented", they are bad and just
+ stubs so we need our own - we need these even in ANSI builds!! */
+ WXDLLIMPEXP_BASE size_t wxMbstowcs (wchar_t *, const char *, size_t);
+ WXDLLIMPEXP_BASE size_t wxWcstombs (char *, const wchar_t *, size_t);
+ #else
+ #define wxMbstowcs mbstowcs
+ #define wxWcstombs wcstombs
+ #endif
+
+ /*
+ The system C library on Mac OS X 10.2 and below does not support
+ unicode: in other words all wide-character functions such as towupper et
+ al. do simply not exist so we need to provide our own in that context,
+ except for the wchar_t definition/typedef itself.
+
+ We need to do this for both project builder and CodeWarrior as
+ the latter uses the system C library in Mach builds for wide character
+ support, which as mentioned does not exist on 10.2 and below.
+ */
+ #if wxUSE_UNICODE && \
+ defined(__DARWIN__) && \
+ ( MAC_OS_X_VERSION_MAX_ALLOWED <= MAC_OS_X_VERSION_10_2 )
+ /* we need everything! */
+ #define wxNEED_WX_STRING_H
+ #define wxNEED_WX_CTYPE_H
+
+ #define wxFgetchar(c) wxFgetc(c, stdin)
+ #define wxFputc wxPutc
+ #define wxFputchar(c) wxPutc(c, stdout)
+ #define wxGetc wxFgetc
+ #define wxGetchar(c) wxFgetc(c, stdin)
+
+ #include <stdio.h>
+
+ #define wxNEED_FGETC
+ #define wxNEED_FGETS
+ #define wxNEED_GETS
+ #define wxNEED_UNGETC
+
+ #define wxNEED_FPUTS
+ #define wxNEED_PUTS
+ #define wxNEED_PUTC
+
+ int wxFputs(const wxChar *ch, FILE *stream);
+ int wxPuts(const wxChar *ws);
+ int wxPutc(wxChar ch, FILE *stream);
+
+ #ifdef __cplusplus
+ extern "C" {
+ #endif
+ WXDLLIMPEXP_BASE size_t wxStrlen_(const wxChar *s);
+ #ifdef __cplusplus
+ }
+ #endif
+
+ #define wxPutchar(wch) wxPutc(wch, stdout)
+
+ #define wxNEED_PRINTF_CONVERSION
+ #define wxNEED_WX_STDIO_H
+ #define wxNEED_WX_STDLIB_H
+ #define wxNEED_WX_TIME_H
+
+ #elif wxUSE_UNICODE
+ #include <wctype.h>
+
+ /* this is probably glibc-specific */
+ #if defined(__WCHAR_TYPE__) && !defined(__MWERKS__)
+ /* ctype.h functions (wctype.h) */
+ #define wxIsalnum iswalnum
+ #define wxIsalpha iswalpha
+ #define wxIscntrl iswcntrl
+ #define wxIsdigit iswdigit
+ #define wxIsgraph iswgraph
+ #define wxIslower iswlower
+ #define wxIsprint iswprint
+ #define wxIspunct iswpunct
+ #define wxIsspace iswspace
+ #define wxIsupper iswupper
+ #define wxIsxdigit iswxdigit
+
+ #if defined(__GLIBC__) && (__GLIBC__ == 2) && (__GLIBC_MINOR__ == 0)
+ /* /usr/include/wctype.h incorrectly declares translations */
+ /* tables which provokes tons of compile-time warnings -- try */
+ /* to correct this */
+ #define wxTolower(wc) towctrans((wc), (wctrans_t)__ctype_tolower)
+ #define wxToupper(wc) towctrans((wc), (wctrans_t)__ctype_toupper)
+ #else /* !glibc 2.0 */
+ #define wxTolower towlower
+ #define wxToupper towupper
+ #endif /* gcc/!gcc */
+
+ /* string.h functions (wchar.h) */
+ #define wxStrcat wcscat
+ #define wxStrchr wcschr
+ #define wxStrcmp wcscmp
+ #define wxStrcoll wcscoll
+ #define wxStrcpy wcscpy
+ #define wxStrcspn wcscspn
+ #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
+ #define wxStrncat wcsncat
+ #define wxStrncmp wcsncmp
+ #define wxStrncpy wcsncpy
+ #define wxStrpbrk wcspbrk
+ #define wxStrrchr wcsrchr
+ #define wxStrspn wcsspn
+ #define wxStrstr wcsstr
+ #define wxStrtod wcstod
+ #define wxStrtol wcstol
+ #define wxStrtoul wcstoul
+ #define wxStrxfrm wcsxfrm
+
+ #define wxFgetc fgetwc
+ #define wxFgetchar fgetwchar
+ #define wxFgets fgetws
+ #define wxFputc fputwc
+ #define wxFputchar fputwchar
+ #define wxGetc getwc
+ #define wxGetchar getwchar
+ #define wxGets getws
+ #define wxUngetc ungetwc
+
+ #ifdef HAVE_FPUTWS
+ #define wxFputs fputws
+ #else
+ #define wxNEED_FPUTS
+ #include <stdio.h>
+ int wxFputs(const wxChar *ch, FILE *stream);
+ #endif
+
+ #ifdef HAVE_WPUTC
+ #define wxPutc wputc
+ #else
+ #define wxNEED_PUTC
+ #include <stdio.h>
+ int wxPutc(wxChar ch, FILE *stream);
+ #endif
+
+ #ifdef HAVE_WPUTCHAR
+ #define wxPutchar wputchar
+ #else
+ #define wxPutchar(wch) wxPutc(wch, stdout)
+ #endif
+
+ #ifdef HAVE_PUTWS
+ #define wxPuts putws
+ #else
+ #define wxNEED_PUTS
+ int wxPuts(const wxChar *ws);
+ #endif
+
+ /* we need %s to %ls conversion for printf and scanf etc */
+ #define wxNEED_PRINTF_CONVERSION
+
+ /* glibc doesn't have wide char equivalents of the other stuff so */
+ /* use our own versions */
+ #define wxNEED_WX_STDIO_H
+ #define wxNEED_WX_STDLIB_H
+ #define wxNEED_WX_TIME_H
+ #elif defined(__MWERKS__) && ( defined(__MSL__) || defined(__MACH__) )
+ /* ctype.h functions (wctype.h) */
+ #define wxIsalnum iswalnum
+ #define wxIsalpha iswalpha
+ #define wxIscntrl iswcntrl
+ #define wxIsdigit iswdigit
+ #define wxIsgraph iswgraph
+ #define wxIslower iswlower
+ #define wxIsprint iswprint
+ #define wxIspunct iswpunct
+ #define wxIsspace iswspace
+ #define wxIsupper iswupper
+ #define wxIsxdigit iswxdigit
+ #define wxTolower towlower
+ #define wxToupper towupper
+
+ /* string.h functions (wchar.h) */
+ #define wxStrcat wcscat
+ #define wxStrchr wcschr
+ #define wxStrcmp wcscmp
+ #define wxStrcoll wcscoll
+ #define wxStrcpy wcscpy
+ #define wxStrcspn wcscspn
+ #define wxStrlen_ wxWcslen /* wxStrlen_() is used in wxStrlen() */
+ #define wxStrncat wcsncat
+ #define wxStrncmp wcsncmp
+ #define wxStrncpy wcsncpy
+ #define wxStrpbrk wcspbrk
+ #define wxStrrchr wcsrchr
+ #define wxStrspn wcsspn
+ #define wxStrstr wcsstr
+ #define wxStrtod wcstod
+ #define wxStrtol wcstol
+ #define wxStrtoul wcstoul
+ #define wxStrxfrm wcsxfrm
+
+ #define wxFgetc fgetwc
+ #define wxFgetchar fgetwchar
+ #define wxFgets fgetws
+ #define wxFputc fputwc
+ #define wxFputchar fputwchar
+ #define wxGetc getwc
+ #define wxGetchar getwchar
+ #define wxGets getws
+ #define wxUngetc ungetwc
+
+ #define wxNEED_PRINTF_CONVERSION
+
+ #define wxPutc putwc
+ #define wxPutchar putwchar
+ #define wxFputs fputws
+
+ /* stdio.h functions */
+
+ #define wxNEED_WX_STDIO_H
+
+ /* stdlib.h functions */
+ #ifdef __MACH__
+ #define wxNEED_WX_STDLIB_H
+ #else
+ #define wxAtof watof
+ #define wxAtoi watoi
+ #define wxAtol watol
+ #define wxGetenv(a) ((wxChar*)NULL)
+ #define wxSystem(a) ((int)NULL)
+ #endif
+ /* time.h functions */
+ #define wxAsctime wasciitime
+ #define wxCtime wctime
+ /* #define wxStrftime wcsftime */
+
+ #define wxNEED_WX_TIME_H
+ #else /* !metrowerks for apple */
+ #error "Please define wide character functions for your environment"
+ #endif
+ #else /* ASCII */
+ #include <ctype.h>
+ #include <string.h>
+
+ /* ctype.h functions */
+ #define wxIsalnum isalnum
+ #define wxIsalpha isalpha
+ #define wxIscntrl iscntrl
+ #define wxIsdigit isdigit
+ #define wxIsgraph isgraph
+ #define wxIslower islower
+ #define wxIsprint isprint
+ #define wxIspunct ispunct
+ #define wxIsspace isspace
+ #define wxIsupper isupper
+ #define wxIsxdigit isxdigit
+ #define wxTolower tolower
+ #define wxToupper toupper
+
+ /* locale.h functons */
+ #define wxSetlocale setlocale
+
+ /* string.h functions */
+ #define wxStrcat strcat
+ #define wxStrchr strchr
+ #define wxStrcmp strcmp
+ #define wxStrcoll strcoll
+ #define wxStrcpy strcpy
+ #define wxStrcspn strcspn
+
+ /* wxStricmp and wxStrnicmp are defined below */
+ #define wxStrlen_ strlen /* used in wxStrlen inline function */
+ #define wxStrncat strncat
+ #define wxStrncmp strncmp
+ #define wxStrncpy strncpy
+ #define wxStrpbrk strpbrk
+ #define wxStrrchr strrchr
+ #define wxStrspn strspn
+ #define wxStrstr strstr
+ #define wxStrtod strtod
+ #ifdef HAVE_STRTOK_R
+ #define wxStrtok(str, sep, last) strtok_r(str, sep, last)
+ #endif
+ #define wxStrtol strtol
+ #define wxStrtoul strtoul
+ #define wxStrxfrm strxfrm
+
+ /* stdio.h functions */
+ #define wxFopen fopen
+ #define wxFreopen freopen
+ #define wxRemove remove
+ #define wxRename rename
+
+ #define wxPerror perror
+ #define wxTmpnam tmpnam
+
+ #define wxFgetc fgetc
+ #define wxFgetchar fgetchar
+ #define wxFgets fgets
+ #define wxFputc fputc
+ #define wxFputs fputs
+ #define wxFputchar fputchar
+ #define wxFprintf fprintf
+ #define wxFscanf fscanf
+ #define wxGetc getc
+ #define wxGetchar getchar
+ #define wxGets gets
+ #define wxPrintf printf
+ #define wxPutc putc
+ #define wxPutchar putchar
+ #define wxPuts puts
+ #define wxScanf scanf
+ #define wxSprintf sprintf
+ #define wxSscanf sscanf
+ #define wxUngetc ungetc
+ #define wxVfprintf vfprintf
+ #define wxVprintf vprintf
+ #define wxVsscanf vsscanf
+ #define wxVsprintf vsprintf
+
+ /* stdlib.h functions */
+ #define wxAtof atof
+ #define wxAtoi atoi
+ #define wxAtol atol
+ #define wxGetenv getenv
+ #define wxSystem system
+
+ /* time.h functions */
+ #define wxAsctime asctime
+ #define wxCtime ctime
+ #define wxStrftime strftime
+ #endif /* Unicode/ASCII */
+#endif /* TCHAR-aware compilers/the others */
+
+/*
+ various special cases
+ */
+
+/* define wxStricmp and wxStrnicmp for various compilers */
+
+/* note that in Unicode mode we definitely are going to need our own version */
#if !defined(wxStricmp) && !wxUSE_UNICODE
-#if defined(__BORLANDC__) || defined(__WATCOMC__) || defined(__SALFORDC__)
- #define wxStricmp stricmp
-#elif defined(__SC__) || defined(__VISUALC__) || (defined(__MWERKS) && defined(__INTEL__))
- #define wxStricmp _stricmp
-#elif defined(__UNIX__) || defined(__GNUWIN32__)
- #define wxStricmp strcasecmp
-#elif defined(__MWERKS__) && !defined(__INTEL__)
- // use wxWindows' implementation
+ #if defined(__BORLANDC__) || defined(__WATCOMC__) || \
+ defined(__SALFORDC__) || defined(__VISAGECPP__) || \
+ defined(__EMX__) || defined(__DJGPP__)
+ #define wxStricmp stricmp
+ #define wxStrnicmp strnicmp
+ #elif defined(__WXPALMOS__)
+ /* FIXME: There is no equivalent to strnicmp in the Palm OS API. This
+ * quick hack should do until one can be written.
+ */
+ #define wxStricmp StrCaselessCompare
+ #define wxStrnicmp strnicmp
+ #elif defined(__SYMANTEC__) || defined(__VISUALC__) || \
+ (defined(__MWERKS__) && defined(__INTEL__))
+ #define wxStricmp _stricmp
+ #define wxStrnicmp _strnicmp
+ #elif defined(__UNIX__) || defined(__GNUWIN32__)
+ #define wxStricmp strcasecmp
+ #define wxStrnicmp strncasecmp
+ /* #else -- use wxWidgets implementation */
+ #endif
+#endif /* !defined(wxStricmp) */
+
+/* define wxWcslen() which should be always available if wxUSE_WCHAR_T == 1 (as */
+/* it's used in wx/buffer.h -- and also might be used just below by wxStrlen() */
+/* when wxStrlen_() is #define'd as wxWcslen so do it before defining wxStrlen) */
+#if wxUSE_WCHAR_T
+ #ifdef HAVE_WCSLEN
+ #define wxWcslen wcslen
+ #else
+ WXDLLIMPEXP_BASE size_t wxWcslen(const wchar_t *s);
+ #endif
+#endif /* wxUSE_WCHAR_T */
+
+#ifdef __cplusplus
+/* checks whether the passed in pointer is NULL and if the string is empty */
+inline bool wxIsEmpty(const wxChar *p) { return !p || !*p; }
+
+/* safe version of strlen() (returns 0 if passed NULL pointer) */
+inline size_t wxStrlen(const wxChar *psz) { return psz ? wxStrlen_(psz) : 0; }
+#endif
+
+/*
+ each of strdup() and wcsdup() may or may not be available but we need both
+ of them anyhow for wx/buffer.h so we define the missing one(s) in
+ wxchar.cpp and so we should always have both wxStrdupA and wxStrdupW
+ defined -- if this is somehow not the case in some situations, please
+ correct that and not the lines here
+ */
+#if wxUSE_UNICODE
+ #define wxStrdup wxStrdupW
#else
- // if you leave wxStricmp undefined, wxWindows' implementation will be used
- #error "Please define string case-insensitive compare for your OS/compiler"
+ #define wxStrdup wxStrdupA
#endif
+
+#ifdef __cplusplus
+WXDLLIMPEXP_BASE bool wxOKlibc(); /* for internal use */
#endif
-// if we need to define for standard headers, and we're not using Unicode,
-// just define to standard C library routines
-#if !wxUSE_UNICODE
-#ifdef wxNEED_WX_STRING_H
-#define wxStrcat strcat
-#define wxStrchr strchr
-#define wxStrcmp strcmp
-#define wxStrcoll strcoll
-#define wxStrcpy strcpy
-#define wxStrcspn strcspn
-#define wxStrdup strdup
-#define wxStrlen_ strlen // used in wxStrlen inline function
-#define wxStrncat strncat
-#define wxStrncmp strncmp
-#define wxStrncpy strncpy
-#define wxStrpbrk strpbrk
-#define wxStrrchr strrchr
-#define wxStrspn strspn
-#define wxStrstr strstr
-#define wxStrtod strtod
-#define wxStrtol strtol
-#define wxStrtoul strtoul
-#define wxStrxfrm strxfrm
-#undef wxNEED_WX_STRING_H
+/* printf() family saga */
+
+/*
+ For some systems [v]snprintf() exists in the system libraries but not in the
+ headers, so we need to declare it ourselves to be able to use it.
+ */
+#if defined(HAVE_VSNPRINTF) && !defined(HAVE_VSNPRINTF_DECL)
+#ifdef __cplusplus
+ extern "C"
+#else
+ extern
#endif
+ int vsnprintf(char *str, size_t size, const char *format, va_list ap);
+#endif /* !HAVE_VSNPRINTF_DECL */
-#ifdef wxNEED_WX_STDIO_H
-#define wxFgetc fgetc
-#define wxFgetchar fgetchar
-#define wxFgets fgets
-#define wxFopen fopen
-#define wxFputc fputc
-#define wxFputchar fputchar
-#define wxFprintf fprintf
-#define wxFreopen freopen
-#define wxFscanf fscanf
-#define wxGetc getc
-#define wxGetchar getchar
-#define wxGets gets
-#define wxPerror perror
-#define wxPrintf printf
-#define wxPutc putc
-#define wxPutchar putchar
-#define wxPuts puts
-#define wxRemove remove
-#define wxRename rename
-#define wxScanf scanf
-#define wxSprintf sprintf
-#define wxSscanf sscanf
-#define wxTmpnam tmpnam
-#define wxUngetc ungetc
-#define wxVfprint vfprintf
-#define wxVprintf vprintf
-#define wxVsscanf vsscanf
-#define wxVsprintf vsprintf
-#undef wxNEED_WX_STDIO_H
+#if defined(HAVE_SNPRINTF) && !defined(HAVE_SNPRINTF_DECL)
+#ifdef __cplusplus
+ extern "C"
+#else
+ extern
#endif
+ int snprintf(char *str, size_t size, const char *format, ...);
+#endif /* !HAVE_SNPRINTF_DECL */
-#ifdef wxNEED_WX_STDLIB_H
-#define wxAtof atof
-#define wxAtoi atoi
-#define wxAtol atol
-#define wxGetenv getenv
-#define wxSystem system
-#undef wxNEED_WX_STDLIB_H
+/* Wrapper for vsnprintf if it's 3rd parameter is non-const. Note: the
+ * same isn't done for snprintf below, the builtin wxSnprintf_ is used
+ * instead since it's already a simple wrapper */
+#if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
+ inline int wx_fixed_vsnprintf(char *str, size_t size, const char *format, va_list ap)
+ {
+ return vsnprintf(str, size, (char*)format, ap);
+ }
#endif
-#ifdef wxNEED_WX_TIME_H
-#define wxAsctime asctime
-#define wxCtime ctime
-#define wxStrftime strftime
-#undef wxNEED_WX_TIME_H
+/*
+ First of all, we always want to define safe snprintf() function to be used
+ instead of sprintf(). Some compilers already have it (or rather vsnprintf()
+ which we really need...), otherwise we implement it using our own printf()
+ code.
+
+ We define function with a trailing underscore here because the real one is a
+ wrapper around it as explained below
+ */
+#ifndef wxVsnprintf_
+ #if wxUSE_UNICODE
+ #ifdef wxHAVE_MWERKS_UNICODE
+ #define HAVE_WCSRTOMBS 1
+ #define HAVE_VSWPRINTF 1
+ #endif /* Metrowerks with Unicode support */
+ #if defined(__WATCOMC__)
+ #define wxVsnprintf_ _vsnwprintf
+ #define wxSnprintf_ _snwprintf
+ #endif /* Watcom */
+ #if defined(HAVE__VSNWPRINTF)
+ #define wxVsnprintf_ _vsnwprintf
+ /* MinGW?MSVCRT has the wrong vswprintf */
+ /* Mac OS X has a somehow buggy vswprintf */
+ #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__) && !defined(__DARWIN__)
+ #define wxVsnprintf_ vswprintf
+ #endif
+ #else /* ASCII */
+ /* all versions of CodeWarrior supported by wxWidgets apparently have */
+ /* both snprintf() and vsnprintf() */
+ #if defined(HAVE_SNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
+ #ifndef HAVE_BROKEN_SNPRINTF_DECL
+ #define wxSnprintf_ snprintf
+ #endif
+ #endif
+ #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__) || defined(__WATCOMC__)
+ #if defined __cplusplus && defined HAVE_BROKEN_VSNPRINTF_DECL
+ #define wxVsnprintf_ wx_fixed_vsnprintf
+ #else
+ #define wxVsnprintf_ vsnprintf
+ #endif
+ #endif
+ #endif
+#endif /* wxVsnprintf_ not defined yet */
+
+#ifndef wxSnprintf_
+ /* no [v]snprintf(), cook our own */
+ WXDLLIMPEXP_BASE int wxSnprintf_(wxChar *buf, size_t len, const wxChar *format,
+ ...) ATTRIBUTE_PRINTF_3;
+#endif
+#ifndef wxVsnprintf_
+ WXDLLIMPEXP_BASE int wxVsnprintf_(wxChar *buf, size_t len, const wxChar *format,
+ va_list argptr);
#endif
-#endif //!Unicode
-#if defined(wxNEED_WCSLEN) && wxUSE_UNICODE
-#define wcslen wxStrlen
-#undef wxNEED_WCSLEN
+/*
+ In Unicode mode we need to have all standard functions such as wprintf() and
+ so on but not all systems have them so use our own implementations in this
+ case.
+ */
+#if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
+ #define wxNEED_WPRINTF
#endif
-/// checks whether the passed in pointer is NULL and if the string is empty
-inline bool WXDLLEXPORT wxIsEmpty(const wxChar *p) { return !p || !*p; }
+/*
+ More Unicode complications: although both ANSI C and C++ define a number of
+ wide character functions such as wprintf(), not all environments have them.
+ Worse, those which do have different behaviours: under Windows, %s format
+ specifier changes its meaning in Unicode build and expects a Unicode string
+ while under Unix/POSIX it still means an ASCII string even for wprintf() and
+ %ls has to be used for wide strings.
-#ifndef wxNEED_WX_STRING_H
-/// safe version of strlen() (returns 0 if passed NULL pointer)
-inline size_t WXDLLEXPORT wxStrlen(const wxChar *psz)
- { return psz ? wxStrlen_(psz) : 0; }
-#endif
+ We choose to always emulate Windows behaviour as more useful for us so even
+ if we have wprintf() we still must wrap it in a non trivial wxPrintf().
-#if wxUSE_WCHAR_T
-// multibyte<->widechar conversion
-size_t WXDLLEXPORT wxMB2WC(wchar_t *buf, const char *psz, size_t n);
-size_t WXDLLEXPORT wxWC2MB(char *buf, const wchar_t *psz, size_t n);
-#if wxUSE_UNICODE
-#define wxMB2WX wxMB2WC
-#define wxWX2MB wxWC2MB
-#define wxWC2WX wxStrncpy
-#define wxWX2WC wxStrncpy
+*/
+
+#if defined(wxNEED_PRINTF_CONVERSION) || defined(wxNEED_WPRINTF)
+ /*
+ we need to implement all wide character printf and scanf functions
+ either because we don't have them at all or because they don't have the
+ semantics we need
+ */
+
+ #include <stdio.h> /* for FILE */
+
+ int wxScanf( const wxChar *format, ... ) ATTRIBUTE_PRINTF_1;
+ int wxSscanf( const wxChar *str, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
+ int wxFscanf( FILE *stream, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
+ int wxVsscanf( const wxChar *str, const wxChar *format, va_list ap );
+ int wxPrintf( const wxChar *format, ... ) ATTRIBUTE_PRINTF_1;
+ int wxSprintf( wxChar *str, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
+ int wxFprintf( FILE *stream, const wxChar *format, ... ) ATTRIBUTE_PRINTF_2;
+ int wxVfprintf( FILE *stream, const wxChar *format, va_list ap );
+ int wxVprintf( const wxChar *format, va_list ap );
+ int wxVsprintf( wxChar *str, const wxChar *format, va_list ap );
+#endif /* wxNEED_PRINTF_CONVERSION */
+
+/* these 2 can be simply mapped to the versions with underscore at the end */
+/* if we don't have to do the conversion */
+/*
+ However, if we don't have any vswprintf() at all we don't need to redefine
+ anything as our own wxVsnprintf_() already behaves as needed.
+*/
+#if defined(wxNEED_PRINTF_CONVERSION) && defined(wxVsnprintf_)
+ int wxSnprintf( wxChar *str, size_t size, const wxChar *format, ... ) ATTRIBUTE_PRINTF_3;
+ int wxVsnprintf( wxChar *str, size_t size, const wxChar *format, va_list ap );
#else
-#define wxMB2WX wxStrncpy
-#define wxWX2MB wxStrncpy
-#define wxWC2WX wxWC2MB
-#define wxWX2WC wxMB2WC
+ #define wxSnprintf wxSnprintf_
+ #define wxVsnprintf wxVsnprintf_
#endif
-#else
-// No wxUSE_WCHAR_T: we have to do something (JACS)
-#define wxMB2WC wxStrncpy
-#define wxWC2MB wxStrncpy
-#define wxMB2WX wxStrncpy
-#define wxWX2MB wxStrncpy
-#define wxWC2WX wxWC2MB
-#define wxWX2WC wxMB2WC
+
+/*
+ various functions which might not be available in libc and for which we
+ provide our own replacements in wxchar.cpp
+ */
+
+/* ctype.h functions */
+
+/* RN: Used only under OSX <= 10.2 currently */
+#ifdef wxNEED_WX_CTYPE_H
+ WXDLLIMPEXP_BASE int wxIsalnum(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIsalpha(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIscntrl(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIsdigit(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIsgraph(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIslower(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIsprint(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIspunct(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIsspace(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIsupper(wxChar ch);
+ WXDLLIMPEXP_BASE int wxIsxdigit(wxChar ch);
+ WXDLLIMPEXP_BASE int wxTolower(wxChar ch);
+ WXDLLIMPEXP_BASE int wxToupper(wxChar ch);
+#endif /* wxNEED_WX_CTYPE_H */
+
+/* under VC++ 6.0 isspace() returns 1 for 8 bit chars which completely breaks */
+/* the file parsing -- this may be true for 5.0 as well, update #ifdef then */
+#if defined(__VISUALC__) && (__VISUALC__ >= 1200) && !wxUSE_UNICODE
+ #undef wxIsspace
+ #define wxIsspace(c) ((((unsigned)c) < 128) && isspace(c))
+#endif /* VC++ */
+
+/*
+ a few compilers don't have the (non standard but common) isascii function,
+ define it ourselves for them
+ */
+#ifndef isascii
+ #if defined(__MWERKS__)
+ #define wxNEED_ISASCII
+ #elif defined(_WIN32_WCE)
+ #if _WIN32_WCE <= 211
+ #define wxNEED_ISASCII
+ #endif
+ #endif
+#endif /* isascii */
+
+#ifdef wxNEED_ISASCII
+ inline int isascii(int c) { return (unsigned)c < 0x80; }
#endif
-bool WXDLLEXPORT wxOKlibc(); // for internal use
+#ifdef _WIN32_WCE
+ #if _WIN32_WCE <= 211
+ #define isspace(c) ((c) == _T(' ') || (c) == _T('\t'))
+ #endif
+#endif /* _WIN32_WCE */
+
+/*
+ we had goofed and defined wxIsctrl() instead of (correct) wxIscntrl() in the
+ initial versions of this header -- now it is too late to remove it so
+ although we fixed the function/macro name above, still provide the
+ backwards-compatible synonym.
+ */
+#define wxIsctrl wxIscntrl
-// if libc versions are not available, use replacements defined in wxchar.cpp
-#ifndef wxStrdup
-wxChar * WXDLLEXPORT wxStrdup(const wxChar *psz);
+/* string.h functions */
+#ifndef strdup
+ #if defined(__MWERKS__) && !defined(__MACH__) && (__MSL__ < 0x00008000)
+ #define wxNEED_STRDUP
+ #elif defined(__WXWINCE__)
+ #if _WIN32_WCE <= 211
+ #define wxNEED_STRDUP
+ #endif
+ #endif
+#endif /* strdup */
+
+#ifdef wxNEED_STRDUP
+ WXDLLIMPEXP_BASE char *strdup(const char* s);
#endif
-#ifndef wxStricmp
-int WXDLLEXPORT wxStricmp(const wxChar *psz1, const wxChar *psz2);
+/* RN: Used only under OSX <= 10.2 currently
+ The __cplusplus ifdefs are messy, but they are required to build
+ the regex library, since c does not support function overloading
+*/
+#ifdef wxNEED_WX_STRING_H
+# ifdef __cplusplus
+ extern "C" {
+# endif
+ WXDLLIMPEXP_BASE wxChar * wxStrcat(wxChar *dest, const wxChar *src);
+ WXDLLIMPEXP_BASE const wxChar * wxStrchr(const wxChar *s, wxChar c);
+ WXDLLIMPEXP_BASE int wxStrcmp(const wxChar *s1, const wxChar *s2);
+ WXDLLIMPEXP_BASE int wxStrcoll(const wxChar *s1, const wxChar *s2);
+ WXDLLIMPEXP_BASE wxChar * wxStrcpy(wxChar *dest, const wxChar *src);
+ WXDLLIMPEXP_BASE size_t wxStrcspn(const wxChar *s, const wxChar *reject);
+ WXDLLIMPEXP_BASE wxChar * wxStrncat(wxChar *dest, const wxChar *src, size_t n);
+ WXDLLIMPEXP_BASE int wxStrncmp(const wxChar *s1, const wxChar *s2, size_t n);
+ WXDLLIMPEXP_BASE wxChar * wxStrncpy(wxChar *dest, const wxChar *src, size_t n);
+ WXDLLIMPEXP_BASE const wxChar * wxStrpbrk(const wxChar *s, const wxChar *accept);
+ WXDLLIMPEXP_BASE const wxChar * wxStrrchr(const wxChar *s, wxChar c);
+ WXDLLIMPEXP_BASE size_t wxStrspn(const wxChar *s, const wxChar *accept);
+ WXDLLIMPEXP_BASE const wxChar * wxStrstr(const wxChar *haystack, const wxChar *needle);
+# ifdef __cplusplus
+ }
+# endif
+
+ /* These functions use C++, so we can't c extern them */
+ WXDLLIMPEXP_BASE double wxStrtod(const wxChar *nptr, wxChar **endptr);
+ WXDLLIMPEXP_BASE long int wxStrtol(const wxChar *nptr, wxChar **endptr, int base);
+ WXDLLIMPEXP_BASE unsigned long int wxStrtoul(const wxChar *nptr, wxChar **endptr, int base);
+ WXDLLIMPEXP_BASE size_t wxStrxfrm(wxChar *dest, const wxChar *src, size_t n);
+
+ /* inlined versions */
+ #ifdef __cplusplus
+ inline wxChar * wxStrchr(wxChar *s, wxChar c)
+ { return (wxChar *)wxStrchr((const wxChar *)s, c); }
+ inline wxChar * wxStrpbrk(wxChar *s, const wxChar *accept)
+ { return (wxChar *)wxStrpbrk((const wxChar *)s, accept); }
+ inline wxChar * wxStrrchr(wxChar *s, wxChar c)
+ { return (wxChar *)wxStrrchr((const wxChar *)s, c); }
+ inline wxChar *wxStrstr(wxChar *haystack, const wxChar *needle)
+ { return (wxChar *)wxStrstr((const wxChar *)haystack, needle); }
+ #endif
+
+#endif /* wxNEED_WX_STRING_H */
+
+#ifndef wxStrdupA
+WXDLLIMPEXP_BASE char *wxStrdupA(const char *psz);
#endif
-#ifndef wxStrtok
-wxChar * WXDLLEXPORT wxStrtok(wxChar *psz, const wxChar *delim, wxChar **save_ptr);
+#ifndef wxStrdupW
+WXDLLIMPEXP_BASE wchar_t *wxStrdupW(const wchar_t *pwz);
#endif
-#ifndef wxSetlocale
-wxChar * WXDLLEXPORT wxSetlocale(int category, const wxChar *locale);
+#ifndef wxStricmp
+WXDLLIMPEXP_BASE int wxStricmp(const wxChar *psz1, const wxChar *psz2);
#endif
-#ifdef wxNEED_WCSLEN // for use in buffer.h
-size_t WXDLLEXPORT wcslen(const wchar_t *s);
+#ifndef wxStrnicmp
+WXDLLIMPEXP_BASE int wxStrnicmp(const wxChar *psz1, const wxChar *psz2, size_t len);
#endif
-#ifdef wxNEED_WX_CTYPE_H
-int WXDLLEXPORT wxIsalnum(wxChar ch);
-int WXDLLEXPORT wxIsalpha(wxChar ch);
-int WXDLLEXPORT wxIsctrl(wxChar ch);
-int WXDLLEXPORT wxIsdigit(wxChar ch);
-int WXDLLEXPORT wxIsgraph(wxChar ch);
-int WXDLLEXPORT wxIslower(wxChar ch);
-int WXDLLEXPORT wxIsprint(wxChar ch);
-int WXDLLEXPORT wxIspunct(wxChar ch);
-int WXDLLEXPORT wxIsspace(wxChar ch);
-int WXDLLEXPORT wxIsupper(wxChar ch);
-int WXDLLEXPORT wxIsxdigit(wxChar ch);
-int WXDLLEXPORT wxTolower(wxChar ch);
-int WXDLLEXPORT wxToupper(wxChar ch);
+#ifndef wxStrtok
+WXDLLIMPEXP_BASE wxChar * wxStrtok(wxChar *psz, const wxChar *delim, wxChar **save_ptr);
#endif
-#ifdef wxNEED_WX_STRING_H
-wxChar * WXDLLEXPORT wxStrcat(wxChar *dest, const wxChar *src);
-wxChar * WXDLLEXPORT wxStrchr(const wxChar *s, wxChar c);
-int WXDLLEXPORT wxStrcmp(const wxChar *s1, const wxChar *s2);
-int WXDLLEXPORT wxStrcoll(const wxChar *s1, const wxChar *s2);
-wxChar * WXDLLEXPORT wxStrcpy(wxChar *dest, const wxChar *src);
-size_t WXDLLEXPORT wxStrcspn(const wxChar *s, const wxChar *reject);
-size_t WXDLLEXPORT wxStrlen(const wxChar *s);
-wxChar * WXDLLEXPORT wxStrncat(wxChar *dest, const wxChar *src, size_t n);
-int WXDLLEXPORT wxStrncmp(const wxChar *s1, const wxChar *s2, size_t n);
-wxChar * WXDLLEXPORT wxStrncpy(wxChar *dest, const wxChar *src, size_t n);
-wxChar * WXDLLEXPORT wxStrpbrk(const wxChar *s, const wxChar *accept);
-wxChar * WXDLLEXPORT wxStrrchr(const wxChar *s, wxChar c);
-size_t WXDLLEXPORT wxStrspn(const wxChar *s, const wxChar *accept);
-wxChar * WXDLLEXPORT wxStrstr(const wxChar *haystack, const wxChar *needle);
-double WXDLLEXPORT wxStrtod(const wxChar *nptr, wxChar **endptr);
-long int WXDLLEXPORT wxStrtol(const wxChar *nptr, wxChar **endptr, int base);
-unsigned long int WXDLLEXPORT wxStrtoul(const wxChar *nptr, wxChar **endptr, int base);
-size_t WXDLLEXPORT wxStrxfrm(wxChar *dest, const wxChar *src, size_t n);
+#ifdef __cplusplus
+#ifndef wxSetlocale
+class WXDLLIMPEXP_BASE wxWCharBuffer;
+WXDLLIMPEXP_BASE wxWCharBuffer wxSetlocale(int category, const wxChar *locale);
+#endif
#endif
+/* stdio.h functions */
#ifdef wxNEED_WX_STDIO_H
-#include <stdio.h>
-#include <stdarg.h>
-int WXDLLEXPORT wxPrintf(const wxChar *fmt, ...);
-int WXDLLEXPORT wxVprintf(const wxChar *fmt, va_list argptr);
-int WXDLLEXPORT wxFprintf(FILE *stream, const wxChar *fmt, ...);
-int WXDLLEXPORT wxVfprintf(FILE *stream, const wxChar *fmt, va_list argptr);
-int WXDLLEXPORT wxSprintf(wxChar *buf, const wxChar *fmt, ...);
-int WXDLLEXPORT wxVsprintf(wxChar *buf, const wxChar *fmt, va_list argptr);
-int WXDLLEXPORT wxSscanf(const wxChar *buf, const wxChar *fmt, ...);
-int WXDLLEXPORT wxVsscanf(const wxChar *buf, const wxChar *fmt, va_list argptr);
-#endif
+ #include <stdio.h>
+ WXDLLIMPEXP_BASE FILE * wxFopen(const wxChar *path, const wxChar *mode);
+ WXDLLIMPEXP_BASE FILE * wxFreopen(const wxChar *path, const wxChar *mode, FILE *stream);
+ WXDLLIMPEXP_BASE int wxRemove(const wxChar *path);
+ WXDLLIMPEXP_BASE int wxRename(const wxChar *oldpath, const wxChar *newpath);
+
+ /* *printf() family is handled separately */
+#endif /* wxNEED_WX_STDIO_H */
+
+/* stdlib.h functions */
#ifndef wxAtof
-double WXDLLEXPORT wxAtof(const wxChar *psz);
+WXDLLIMPEXP_BASE double wxAtof(const wxChar *psz);
#endif
#ifdef wxNEED_WX_STDLIB_H
-int WXDLLEXPORT wxAtoi(const wxChar *psz);
-long WXDLLEXPORT wxAtol(const wxChar *psz);
-wxChar * WXDLLEXPORT wxGetenv(const wxChar *name);
-int WXDLLEXPORT wxSystem(const wxChar *psz);
+WXDLLIMPEXP_BASE int wxAtoi(const wxChar *psz);
+WXDLLIMPEXP_BASE long wxAtol(const wxChar *psz);
+WXDLLIMPEXP_BASE wxChar * wxGetenv(const wxChar *name);
+WXDLLIMPEXP_BASE int wxSystem(const wxChar *psz);
#endif
+
+/* time.h functions */
+#ifdef wxNEED_WX_TIME_H
+#if defined(__MWERKS__) && defined(macintosh)
+ #include <time.h>
#endif
- //_WX_WXCHAR_H_
+ /*silent gabby compilers*/
+ struct tm;
+ WXDLLIMPEXP_BASE size_t wxStrftime(wxChar *s, size_t max,
+ const wxChar *fmt, const struct tm *tm);
+#endif /* wxNEED_WX_TIME_H */
+
+#ifndef wxCtime
+#include <time.h>
+WXDLLIMPEXP_BASE wxChar *wxCtime(const time_t *timep);
+#endif
+
+
+/* missing functions in some WinCE versions */
+#ifdef _WIN32_WCE
+#if (_WIN32_WCE < 300)
+WXDLLIMPEXP_BASE void *calloc( size_t num, size_t size );
+#endif
+#endif /* _WIN32_WCE */
+
+/* multibyte to wide char conversion functions and macros */
+
+#if wxUSE_WCHAR_T
+ /* multibyte<->widechar conversion */
+ WXDLLIMPEXP_BASE size_t wxMB2WC(wchar_t *buf, const char *psz, size_t n);
+ WXDLLIMPEXP_BASE size_t wxWC2MB(char *buf, const wchar_t *psz, size_t n);
+
+ #if wxUSE_UNICODE
+ #define wxMB2WX wxMB2WC
+ #define wxWX2MB wxWC2MB
+ #define wxWC2WX wxStrncpy
+ #define wxWX2WC wxStrncpy
+ #else
+ #define wxMB2WX wxStrncpy
+ #define wxWX2MB wxStrncpy
+ #define wxWC2WX wxWC2MB
+ #define wxWX2WC wxMB2WC
+ #endif
+#else /* !wxUSE_UNICODE */
+/* Why is this here?
+#error ha */
+ /* No wxUSE_WCHAR_T: we have to do something (JACS) */
+ #define wxMB2WC wxStrncpy
+ #define wxWC2MB wxStrncpy
+ #define wxMB2WX wxStrncpy
+ #define wxWX2MB wxStrncpy
+ #define wxWC2WX wxWC2MB
+ #define wxWX2WC wxMB2WC
+#endif
+
+/*
+ RN: The following are not normal versions of memcpy et al., rather
+ these are either char or widechar versions depending on
+ if unicode is used or not.
+*/
+
+#ifdef __cplusplus
+
+ //
+ // RN: We could do the usual tricky compiler detection here,
+ // and use their variant (such as wmemchr, etc.). The problem
+ // is that these functions are quite rare, even though they are
+ // part of the current POSIX standard. In addition, most compilers
+ // (including even MSC) inline them just like we do right in their
+ // headers.
+ //
+ #if wxUSE_UNICODE
+ #include <string.h> //for mem funcs
+
+ //implement our own wmem variants
+ inline wxChar* wxTmemchr(const wxChar* s, wxChar c, size_t l)
+ {
+ for(;l && *s != c;--l, ++s) {}
+
+ if(l)
+ return (wxChar*)s;
+ return NULL;
+ }
+
+ inline int wxTmemcmp(const wxChar* sz1, const wxChar* sz2, size_t len)
+ {
+ for(; *sz1 == *sz2 && len; --len, ++sz1, ++sz2) {}
+
+ if(len)
+ return *sz1 < *sz2 ? -1 : *sz1 > *sz2;
+ else
+ return 0;
+ }
+
+ inline wxChar* wxTmemcpy(wxChar* szOut, const wxChar* szIn, size_t len)
+ {
+ return (wxChar*) memcpy(szOut, szIn, len * sizeof(wxChar));
+ }
+
+ inline wxChar* wxTmemmove(wxChar* szOut, const wxChar* szIn, size_t len)
+ {
+ return (wxChar*) memmove(szOut, szIn, len * sizeof(wxChar));
+ }
+
+ inline wxChar* wxTmemset(wxChar* szOut, const wxChar cIn, size_t len)
+ {
+ wxChar* szRet = szOut;
+
+ while (len--)
+ *szOut++ = cIn;
+
+ return szRet;
+ }
+
+ #else /* !wxUSE_UNICODE */
+ # define wxTmemchr memchr
+ # define wxTmemcmp memcmp
+ # define wxTmemcpy memcpy
+ # define wxTmemmove memmove
+ # define wxTmemset memset
+ #endif /* wxUSE_UNICODE/!wxUSE_UNICODE */
+
+#endif /*__cplusplus*/
+
+
+#endif /* _WX_WXCHAR_H_ */
+