trying to make comments readable again after their auto-mangling by RN...

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@25547 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
2004-02-07 12:51:44 +00:00
parent 8dbb97958a
commit 386d53dc2e

View File

@@ -1,4 +1,4 @@
/**
/*
* Name: wx/wxchar.h
* Purpose: Declarations common to wx char/wchar_t usage (wide chars)
* Author: Joel Farley, Ove K<>ven
@@ -20,10 +20,7 @@
#include "wx/defs.h" /* for wxUSE_UNICODE */
/* ---------------------------------------------------------------------------- */
/* check whether we have wchar_t and which size it is if we do */
/* ---------------------------------------------------------------------------- */
#if !defined(wxUSE_WCHAR_T)
#if defined(__WIN16__)
/* no wchar_t under Win16 regadrless of compiler used */
@@ -51,12 +48,12 @@
#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! */
/* ---------------------------------------------------------------------------- */
/*
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>
@@ -68,9 +65,12 @@
#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 */
/*
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
@@ -227,13 +227,13 @@
#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 */
/* ---------------------------------------------------------------------------- */
/*
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>
@@ -606,12 +606,12 @@
#endif /* Unicode/ASCII */
#endif /* TCHAR-aware compilers/the others */
/* ---------------------------------------------------------------------------- */
/* various special cases */
/* ---------------------------------------------------------------------------- */
/*
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__) || \
@@ -656,11 +656,13 @@ inline bool wxIsEmpty(const wxChar *p) { return !p || !*p; }
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 */
/*
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
@@ -670,9 +672,8 @@ inline size_t wxStrlen(const wxChar *psz) { return psz ? wxStrlen_(psz) : 0; }
#ifdef __cplusplus
WXDLLIMPEXP_BASE bool wxOKlibc(); /* for internal use */
#endif
/* ---------------------------------------------------------------------------- */
/* printf() family saga */
/* ---------------------------------------------------------------------------- */
/*
For some systems vsnprintf() exists in the system libraries but not in the
@@ -757,9 +758,11 @@ WXDLLIMPEXP_BASE bool wxOKlibc(); /* for internal use */
#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 */
/*
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 */
@@ -785,13 +788,13 @@ WXDLLIMPEXP_BASE bool wxOKlibc(); /* for internal use */
#define wxVsnprintf wxVsnprintf_
#endif
/* ---------------------------------------------------------------------------- */
/* various functions which might not be available in libc and for which we */
/* provide our own replacements in wxchar.cpp */
/* ---------------------------------------------------------------------------- */
/*
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);
@@ -825,7 +828,7 @@ WXDLLIMPEXP_BASE bool wxOKlibc(); /* for internal use */
#define wxIsctrl wxIscntrl
/* string.h functions */
/* */
/* VZ: this is never defined neither currently */
#ifdef wxNEED_WX_STRING_H
WXDLLIMPEXP_BASE wxChar * wxStrcat(wxChar *dest, const wxChar *src);
@@ -930,9 +933,7 @@ WXDLLIMPEXP_BASE int isascii( int c );
#endif
#endif
/* ---------------------------------------------------------------------------- */
/* multibyte to wide char conversion functions and macros */
/* ---------------------------------------------------------------------------- */
#if wxUSE_WCHAR_T
/* multibyte<->widechar conversion */