///////////////////////////////////////////////////////////////////////////// // 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 ///////////////////////////////////////////////////////////////////////////// #ifndef _WX_WXCHAR_H_ #define _WX_WXCHAR_H_ #ifdef __GNUG__ #pragma interface "wxchar.h" #endif // only do SBCS or _UNICODE #if defined (_MBCS ) // It may be OK anyway. // # error "MBCS is not supported by wxChar" #endif // ---------------------------------------------------------------------------- // first deal with Unicode setting // ---------------------------------------------------------------------------- // 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 // Unicode support requires wchar_t #if wxUSE_UNICODE # undef wxUSE_WCHAR_T # define wxUSE_WCHAR_T 1 #endif // Unicode // ---------------------------------------------------------------------------- // define wxHAVE_TCHAR_FUNCTIONS for the compilers which support the // wide-character functions // ---------------------------------------------------------------------------- #ifdef __WIN32__ // VC++ and BC++ starting with 5.2 have TCHAR support #ifdef __VISUALC__ #define wxHAVE_TCHAR_FUNCTIONS #elif defined(__BORLANDC__) && (__BORLANDC__ >= 0x520) #define wxHAVE_TCHAR_FUNCTIONS #endif #elif defined(__VISAGECPP__) && (__IBMCPP__ >= 400) // VisualAge 4.0+ supports TCHAR #define wxHAVE_TCHAR_FUNCTIONS // but not stdio.h nor time nor conversion functions #define wxNO_TCHAR_STDIO #define wxNO_TCHAR_STDLIB #define wxNO_TCHAR_TIME #define wxNO_TCHAR_LOCALE // // supplemental VA V4 defs so at least we know what these are // just define to standard defs // // for wcslen #include // locale.h functons -- not defined in tchar.h #define wxSetlocale setlocale // some stdio functions are defined others are not // these are not #define wxFgetchar fgetchar #define wxFopen fopen #define wxFputchar fputchar #define wxFreopen freopen #define wxGets gets #define wxPerror perror #define wxPuts puts #define wxRemove remove #define wxRename rename #define wxTmpnam tmpnam #define wxUngetc ungetc #define wxVsscanf vsscanf // stdlib not defined in VA V4 #if !wxUSE_UNICODE # define wxAtof atof #endif #define wxAtoi atoi #define wxAtol atol #define wxGetenv getenv #define wxSystem system // time.h functions -- none defined in tchar.h #define wxAsctime asctime #define wxCtime ctime #endif // compilers with (good) TCHAR support #ifdef wxHAVE_TCHAR_FUNCTIONS # define HAVE_WCSLEN 1 # include # 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 #ifndef wxUSE_WCHAR_T #define wxUSE_WCHAR_T 1 #endif // !defined(wxUSE_WCHAR_T) // ctype.h functions #ifndef wxNO_TCHAR_CTYPE #ifdef __BORLANDC__ # include #endif # 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 #endif // wxNO_TCHAR_CTYPE // locale.h functons #ifndef wxNO_TCHAR_LOCALE # define wxSetlocale _tsetlocale #endif // wxNO_TCHAR_LOCALE // string.h functions #ifndef wxNO_TCHAR_STRING # 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 # define wxStrtol _tcstol # define wxStrtoul _tcstoul # define wxStrxfrm _tcsxfrm #endif // wxNO_TCHAR_STRING // stdio.h functions #ifndef wxNO_TCHAR_STDIO # 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 #elif defined(__VISAGECPP__) && (__IBMCPP__ >= 400) // it has some stdio.h functions, apparently # define wxFgetc _fgettc # define wxFgets _fgetts # define wxFputc _fputtc # define wxFprintf _ftprintf # define wxFscanf _ftscanf # define wxGetc _gettc # define wxGetchar _gettchar # define wxPrintf _tprintf # define wxPutc _puttc # define wxPutchar _puttchar # define wxScanf _tscanf # define wxSprintf _stprintf # define wxSscanf _stscanf # define wxVfprint _vftprintf # define wxVprintf _vtprintf # define wxVsprintf _vstprintf #endif // wxNO_TCHAR_STDIO // stdlib.h functions #ifndef wxNO_TCHAR_STDLIB # if !wxUSE_UNICODE # define wxAtof atof # endif # define wxAtoi _ttoi # define wxAtol _ttol # define wxGetenv _tgetenv # define wxSystem _tsystem #endif // wxNO_TCHAR_STDLIB // time.h functions #ifndef wxNO_TCHAR_TIME # define wxAsctime _tasctime # define wxCtime _tctime #endif // wxNO_TCHAR_TIME #else // !TCHAR-aware compilers // check whether we should include wchar.h or equivalent # if !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 # elif defined(__BORLANDC__) // WIN16 BC++ # define wxUSE_WCHAR_T 0 # elif defined(__WATCOMC__) # define wxUSE_WCHAR_T 0 # elif defined(__VISAGECPP__) && (__IBMCPP__ >= 400) # define wxUSE_WCHAR_T 1 # else // add additional compiler checks if this fails # define wxUSE_WCHAR_T 1 # endif # endif // !defined(wxUSE_WCHAR_T) # if wxUSE_WCHAR_T # ifdef HAVE_WCSTR_H # include # else # ifndef __FreeBSD__ # include # else # include # define wxNEED_WCSLEN # endif # endif # endif // check whether we are doing Unicode # if wxUSE_UNICODE # include // 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 # include # 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 # if defined(__FreeBSD__) || defined(__MACH__) # undef _T # endif # if !defined(__MINGW32__) || !defined(_T) # define _T(x) x # endif // 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 // wxStricmp is defined below!! #ifdef HAVE_STRTOK_R #define wxStrtok(str, sep, last) strtok_r(str, sep, last) #else #define wxStrtok(str, sep, last) strtok(str, sep) #endif // 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 #if !defined(wxStricmp) && !wxUSE_UNICODE # if defined(__BORLANDC__) || defined(__WATCOMC__) || defined(__SALFORDC__) || defined(__VISAGECPP__) || defined(__EMX__) # define wxStricmp stricmp # define wxStrnicmp strnicmp # elif defined(__SC__) || defined(__VISUALC__) || (defined(__MWERKS__) && defined(__INTEL__)) # define wxStricmp _stricmp # define wxStrnicmp _strnicmp # elif defined(__UNIX__) || defined(__GNUWIN32__) || defined(__MACH__) # define wxStricmp strcasecmp # define wxStrnicmp strncasecmp # elif defined(__MWERKS__) && !defined(__INTEL__) // use wxWindows' implementation # else // if you leave wxStricmp undefined, wxWindows' implementation will be used # error "Please define string case-insensitive compare for your OS/compiler" # endif #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 # endif # 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 # endif # 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 # endif # ifdef wxNEED_WX_TIME_H # define wxAsctime asctime # define wxCtime ctime # define wxStrftime strftime # undef wxNEED_WX_TIME_H # endif #endif //!Unicode #if defined(wxNEED_WCSLEN) && wxUSE_UNICODE # define wcslen wxStrlen # undef wxNEED_WCSLEN #endif // checks whether the passed in pointer is NULL and if the string is empty WXDLLEXPORT inline bool wxIsEmpty(const wxChar *p) { return !p || !*p; } #ifndef wxNEED_WX_STRING_H // safe version of strlen() (returns 0 if passed NULL pointer) WXDLLEXPORT inline size_t wxStrlen(const wxChar *psz) { return psz ? wxStrlen_(psz) : 0; } #endif #if wxUSE_WCHAR_T // multibyte<->widechar conversion WXDLLEXPORT size_t wxMB2WC(wchar_t *buf, const char *psz, size_t n); WXDLLEXPORT 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 // 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 WXDLLEXPORT bool wxOKlibc(); // for internal use // if libc versions are not available, use replacements defined in wxchar.cpp #ifndef wxStrdup WXDLLEXPORT wxChar * wxStrdup(const wxChar *psz); #endif #ifndef wxStricmp WXDLLEXPORT int wxStricmp(const wxChar *psz1, const wxChar *psz2); #endif #ifndef wxStrtok WXDLLEXPORT wxChar * wxStrtok(wxChar *psz, const wxChar *delim, wxChar **save_ptr); #endif #ifndef wxSetlocale class wxWCharBuffer; WXDLLEXPORT wxWCharBuffer wxSetlocale(int category, const wxChar *locale); #endif #ifdef wxNEED_WCSLEN // for use in buffer.h WXDLLEXPORT size_t wcslen(const wchar_t *s); #endif #ifdef wxNEED_WX_CTYPE_H WXDLLEXPORT int wxIsalnum(wxChar ch); WXDLLEXPORT int wxIsalpha(wxChar ch); WXDLLEXPORT int wxIsctrl(wxChar ch); WXDLLEXPORT int wxIsdigit(wxChar ch); WXDLLEXPORT int wxIsgraph(wxChar ch); WXDLLEXPORT int wxIslower(wxChar ch); WXDLLEXPORT int wxIsprint(wxChar ch); WXDLLEXPORT int wxIspunct(wxChar ch); WXDLLEXPORT int wxIsspace(wxChar ch); WXDLLEXPORT int wxIsupper(wxChar ch); WXDLLEXPORT int wxIsxdigit(wxChar ch); WXDLLEXPORT int wxTolower(wxChar ch); WXDLLEXPORT int wxToupper(wxChar ch); #endif #ifdef wxNEED_WX_STRING_H WXDLLEXPORT wxChar * wxStrcat(wxChar *dest, const wxChar *src); WXDLLEXPORT wxChar * wxStrchr(const wxChar *s, wxChar c); WXDLLEXPORT int wxStrcmp(const wxChar *s1, const wxChar *s2); WXDLLEXPORT int wxStrcoll(const wxChar *s1, const wxChar *s2); WXDLLEXPORT wxChar * wxStrcpy(wxChar *dest, const wxChar *src); WXDLLEXPORT size_t wxStrcspn(const wxChar *s, const wxChar *reject); WXDLLEXPORT size_t wxStrlen(const wxChar *s); WXDLLEXPORT wxChar * wxStrncat(wxChar *dest, const wxChar *src, size_t n); WXDLLEXPORT int wxStrncmp(const wxChar *s1, const wxChar *s2, size_t n); WXDLLEXPORT wxChar * wxStrncpy(wxChar *dest, const wxChar *src, size_t n); WXDLLEXPORT wxChar * wxStrpbrk(const wxChar *s, const wxChar *accept); WXDLLEXPORT wxChar * wxStrrchr(const wxChar *s, wxChar c); WXDLLEXPORT size_t wxStrspn(const wxChar *s, const wxChar *accept); WXDLLEXPORT wxChar * wxStrstr(const wxChar *haystack, const wxChar *needle); WXDLLEXPORT double wxStrtod(const wxChar *nptr, wxChar **endptr); WXDLLEXPORT long int wxStrtol(const wxChar *nptr, wxChar **endptr, int base); WXDLLEXPORT unsigned long int wxStrtoul(const wxChar *nptr, wxChar **endptr, int base); WXDLLEXPORT size_t wxStrxfrm(wxChar *dest, const wxChar *src, size_t n); #endif #ifdef wxNEED_WX_STDIO_H # include # include WXDLLEXPORT FILE * wxFopen(const wxChar *path, const wxChar *mode); WXDLLEXPORT FILE * wxFreopen(const wxChar *path, const wxChar *mode, FILE *stream); WXDLLEXPORT int wxRemove(const wxChar *path); WXDLLEXPORT int wxRename(const wxChar *oldpath, const wxChar *newpath); WXDLLEXPORT int wxPrintf(const wxChar *fmt, ...); WXDLLEXPORT int wxVprintf(const wxChar *fmt, va_list argptr); WXDLLEXPORT int wxFprintf(FILE *stream, const wxChar *fmt, ...); WXDLLEXPORT int wxVfprintf(FILE *stream, const wxChar *fmt, va_list argptr); WXDLLEXPORT int wxSprintf(wxChar *buf, const wxChar *fmt, ...); WXDLLEXPORT int wxVsprintf(wxChar *buf, const wxChar *fmt, va_list argptr); WXDLLEXPORT int wxSscanf(const wxChar *buf, const wxChar *fmt, ...); WXDLLEXPORT int wxVsscanf(const wxChar *buf, const wxChar *fmt, va_list argptr); #endif #ifndef wxAtof WXDLLEXPORT double wxAtof(const wxChar *psz); #endif #ifdef wxNEED_WX_STDLIB_H WXDLLEXPORT int wxAtoi(const wxChar *psz); WXDLLEXPORT long wxAtol(const wxChar *psz); WXDLLEXPORT wxChar * wxGetenv(const wxChar *name); WXDLLEXPORT int wxSystem(const wxChar *psz); #endif #ifdef wxNEED_WX_TIME_H WXDLLEXPORT size_t wxStrftime(wxChar *s, size_t max, const wxChar *fmt, const struct tm *tm); #endif // ---------------------------------------------------------------------------- // common macros which are always defined // ---------------------------------------------------------------------------- // although global macros with such names are really 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) // a Unicode-friendly __FILE__ analog #ifndef __TFILE__ #define __XFILE__(x) wxT(x) #define __TFILE__ __XFILE__(__FILE__) #endif #endif //_WX_WXCHAR_H_