-/////////////////////////////////////////////////////////////////////////////
-// 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
-// Created: 1998/06/12
-// RCS-ID: $Id$
-// Copyright: (c) 1998-2002 wxWindows dev team
-// Licence: wxWindows licence
-/////////////////////////////////////////////////////////////////////////////
-
-#ifndef _WX_WXCHAR_H_
-#define _WX_WXCHAR_H_
-
-#if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
- #pragma interface "wxchar.h"
-#endif
-
-// ----------------------------------------------------------------------------
-// first deal with Unicode setting: wxUSE_UNICODE should be defined as 0 or 1
-// and is used by wxWindows, _UNICODE and/or UNICODE may be defined or used by
-// the system headers so bring these settings in sync
-// ----------------------------------------------------------------------------
-
-// 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 // Unicode
-
-// and vice versa: define UNICODE and _UNICODE if wxUSE_UNICODE is 1...
-#if wxUSE_UNICODE
- #ifndef _UNICODE
- #define _UNICODE
- #endif
- #ifndef UNICODE
- #define UNICODE
- #endif
-#endif // Unicode
-
-// check whether we have wchar_t
-#if !defined(wxUSE_WCHAR_T)
- #if defined(__WIN16__)
- // no wchar_t under Win16 regadrless of compiler used
- #define wxUSE_WCHAR_T 0
- #elif 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)
-
-// 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 wxWindows headers here because almost 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(__MWERKS__) && defined(__WXMAC__)) && !defined(__WXWINCE__)
- // use #define, not inline wrapper, as it is tested with #ifndef below
- #define wxStrdupA strdup
-#endif
-
-// 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__)
- #ifndef HAVE_WCHAR_H
- #define HAVE_WCHAR_H
- #endif
-#endif
-
-#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>
- extern "C" {
- #endif // Cygwin
- #include <wchar.h>
- #ifdef __CYGWIN__
- }
- #endif // Cygwin
- #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(__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
-
-#ifdef __MWERKS__
- #define HAVE_WPRINTF
-#endif
-
-#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?
-
-#if !wxUSE_UNICODE
- 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
-
- // 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: wxWindows 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
-
-// could already be defined by tchar.h (it's quasi standard)
-#ifndef _T
- #if !wxUSE_UNICODE
- #define _T(x) x
- #else // Unicode
- #define _T(x) L ## x
- #endif // ASCII/Unicode
-#endif // !defined(_T)
-
-// 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 wxWindows sources
-#define wxT(x) _T(x)
-
-// Unicode-friendly __FILE__, __DATE__ and __TIME__ analogs
-#ifndef __TFILE__
- #define __XFILE__(x) wxT(x)
- #define __TFILE__ __XFILE__(__FILE__)
-#endif
-
-#ifndef __TDATE__
- #define __XDATE__(x) wxT(x)
- #define __TDATE__ __XDATE__(__DATE__)
-#endif
-
-#ifndef __TTIME__
- #define __XTIME__(x) wxT(x)
- #define __TTIME__ __XTIME__(__TIME__)
-#endif
-
-// ----------------------------------------------------------------------------
-// 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
-// ----------------------------------------------------------------------------
-
-#ifdef wxHAVE_TCHAR_SUPPORT
- #include <ctype.h>
-
- // 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 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
- #define wxFopen _tfopen
- #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 _puttc
- #define wxPutchar _puttchar
- #define wxPuts _putts
- #define wxScanf _tscanf
- #define wxSprintf _stprintf
- #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__
- #define wxRemove DeleteFile
- #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?)
- #define wxGetenv _tgetenv
- #define wxSystem _tsystem
-
- // time.h functions
- #define wxAsctime _tasctime
- #define wxCtime _tctime
-#else // !TCHAR-aware compilers
- #if wxUSE_UNICODE
- #include <wctype.h>
-
- // this is probably glibc-specific
- #if defined(__WCHAR_TYPE__)
- // 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 // !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_FPUTWC
- #define wxPutc wputc
- #define wxPutchar wputchar
- #define wxPuts putws
- #define wxFputs fputws
- #else
- #define wxNEED_FPUTWC
-
- #include <stdio.h>
-
- int wxFputs(const wxChar *ch, FILE *stream);
- int wxPutc(wxChar ch, FILE *stream);
-
- #define wxPuts(ws) wxFputs(ws, stdout)
- #define wxPutchar(wch) wxPutc(wch, stdout)
- #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(macintosh) || defined(__MACH__) )
- // 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
- #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
- #define wxAtof watof
- #define wxAtoi watoi
- #define wxAtol watol
- #define wxGetenv(a) ((wxChar*)NULL)
- #define wxSystem(a) ((int)NULL)
-
- // time.h functions
- #define wxAsctime wasciitime
- #define wxCtime wctime
- // #define wxStrftime wcsftime
-
- /*
- #define wxNEED_FPUTWC
-
- #include <stdio.h>
-
- int wxFputs(const wxChar *ch, FILE *stream);
- int wxPutc(wxChar ch, FILE *stream);
-
- #define wxPuts(ws) wxFputs(ws, stdout)
- #define wxPutchar(wch) wxPutc(wch, stdout)
-
- // 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
- #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 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 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__) || defined(__VISAGECPP__) || \
- defined(__EMX__) || defined(__DJGPP__)
- #define wxStricmp stricmp
- #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 wxWindows 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
- inline size_t wxWcslen(const wchar_t *s)
- {
- size_t n = 0;
- while ( *s++ )
- n++;
-
- return n;
- }
- #endif
-#endif // wxUSE_WCHAR_T
-
-// 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; }
-
-// 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
- #define wxStrdup wxStrdupA
-#endif
-
-WXDLLIMPEXP_BASE bool wxOKlibc(); // for internal use
-
-// ----------------------------------------------------------------------------
-// printf() family saga
-// ----------------------------------------------------------------------------
-
-/*
- For some systems vsnprintf() 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)
- extern "C"
- int vsnprintf(char *str, size_t size, const char *format, va_list ap);
-#endif // !HAVE_VSNPRINTF_DECL
-
-/*
- 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
- #if defined(__MWERKS__)
- #define HAVE_WCSRTOMBS 1
- #define HAVE_VSWPRINTF 1
- #endif
- #if defined(HAVE__VSNWPRINTF)
- #define wxVsnprintf_ _vsnwprintf
- /* MinGW?MSVCRT has the wrong vswprintf */
- #elif defined(HAVE_VSWPRINTF) && !defined(__MINGW32__)
- #define wxVsnprintf_ vswprintf
- #endif
- #else // ASCII
- // all versions of CodeWarrior supported by wxWindows apparently have
- // vsnprintf()
- #if defined(HAVE_VSNPRINTF) || defined(__MWERKS__)
- // assume we have snprintf() too if we have vsnprintf()
- #define wxVsnprintf_ vsnprintf
- #define wxSnprintf_ snprintf
- #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
-
/*
- 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.
+ * 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-2006 wxWidgets dev team
+ * Licence: wxWindows licence
*/
-#if wxUSE_UNICODE && !defined(wxHAVE_TCHAR_SUPPORT) && !defined(HAVE_WPRINTF)
- #define wxNEED_WPRINTF
-#endif
-/*
- 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.
-
- 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().
-
- 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.
-*/
-#ifndef wxVsnprintf_
- #undef wxNEED_PRINTF_CONVERSION
-#endif
-
-#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
-#ifdef wxNEED_PRINTF_CONVERSION
- 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 wxSnprintf wxSnprintf_
- #define wxVsnprintf wxVsnprintf_
-#endif
-
-// ----------------------------------------------------------------------------
-// various functions which might not be available in libc and for which we
-// provide our own replacements in wxchar.cpp
-// ----------------------------------------------------------------------------
-
-// ctype.h functions
-//
-// VZ: note that this is never defined currently
-#ifdef wxNEED_WX_CTYPE_H
- WXDLLIMPEXP_BASE int wxIsalnum(wxChar ch);
- WXDLLIMPEXP_BASE int wxIsalpha(wxChar ch);
- WXDLLIMPEXP_BASE int wxIsctrl(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++
-
-
-// string.h functions
-//
-// VZ: this is never defined neither currently
-#ifdef wxNEED_WX_STRING_H
- WXDLLIMPEXP_BASE wxChar * wxStrcat(wxChar *dest, const wxChar *src);
- WXDLLIMPEXP_BASE const wxChar * wxStrchr(const wxChar *s, wxChar c);
- WXDLLIMPEXP_BASE wxChar * wxStrchr(wxChar *s, wxChar c)
- { return (wxChar *)wxStrchr((const wxChar *)s, 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 size_t wxStrlen(const wxChar *s);
- 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 wxChar * wxStrpbrk(wxChar *s, const wxChar *accept)
- { return (wxChar *)wxStrpbrk((const wxChar *)s, accept); }
- WXDLLIMPEXP_BASE const wxChar * wxStrrchr(const wxChar *s, wxChar c);
- WXDLLIMPEXP_BASE wxChar * wxStrrchr(wxChar *s, wxChar c)
- { return (wxChar *)wxStrrchr((const wxChar *)s, c); }
- WXDLLIMPEXP_BASE size_t wxStrspn(const wxChar *s, const wxChar *accept);
- WXDLLIMPEXP_BASE const wxChar * wxStrstr(const wxChar *haystack, const wxChar *needle);
- WXDLLIMPEXP_BASE wxChar *wxStrstr(wxChar *haystack, const wxChar *needle)
- { return (wxChar *)wxStrstr((const wxChar *)haystack, needle); }
- 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);
-#endif // wxNEED_WX_STRING_H
-
-#ifndef wxStrdupA
-WXDLLIMPEXP_BASE char *wxStrdupA(const char *psz);
-#endif
-
-#ifndef wxStrdupW
-WXDLLIMPEXP_BASE wchar_t *wxStrdupW(const wchar_t *pwz);
-#endif
-
-#ifndef wxStricmp
-WXDLLIMPEXP_BASE int wxStricmp(const wxChar *psz1, const wxChar *psz2);
-#endif
+/* THIS IS A C FILE, DON'T USE C++ FEATURES (IN PARTICULAR COMMENTS) IN IT */
-#ifndef wxStrnicmp
-WXDLLIMPEXP_BASE int wxStrnicmp(const wxChar *psz1, const wxChar *psz2, size_t len);
-#endif
-
-#ifndef wxStrtok
-WXDLLIMPEXP_BASE wxChar * wxStrtok(wxChar *psz, const wxChar *delim, wxChar **save_ptr);
-#endif
-
-#ifndef wxSetlocale
-class WXDLLIMPEXP_BASE wxWCharBuffer;
-WXDLLIMPEXP_BASE wxWCharBuffer wxSetlocale(int category, const wxChar *locale);
-#endif
-
-// stdio.h functions
-#ifdef wxNEED_WX_STDIO_H
- #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
-WXDLLIMPEXP_BASE double wxAtof(const wxChar *psz);
-#endif
-
-#ifdef wxNEED_WX_STDLIB_H
-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
- WXDLLIMPEXP_BASE size_t wxStrftime(wxChar *s, size_t max,
- const wxChar *fmt, const struct tm *tm);
-#endif // wxNEED_WX_TIME_H
-
-// missing functions in WinCE
-#ifdef __WXWINCE__
-WXDLLIMPEXP_BASE char* strdup(const char* s);
-WXDLLIMPEXP_BASE void *calloc( size_t num, size_t size );
-
-#if _WIN32_WCE <= 211
-WXDLLIMPEXP_BASE int isspace(int c);
-WXDLLIMPEXP_BASE int isascii( int c );
-#endif
-#endif
-
-// ----------------------------------------------------------------------------
-// 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);
+#ifndef _WX_WXCHAR_H_
+#define _WX_WXCHAR_H_
- #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
- // 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
+/* include wxChar type definition: */
+#include "wx/chartype.h"
-#endif //_WX_WXCHAR_H_
+/* and wrappers for CRT functions: */
+#include "wx/wxcrt.h"
+#include "wx/wxcrtvararg.h"
+#endif /* _WX_WXCHAR_H_ */
projects / wxWidgets.git / blobdiff