3f66f6a5b3
This keyword is not expanded by Git which means it's not replaced with the correct revision value in the releases made using git-based scripts and it's confusing to have lines with unexpanded "$Id$" in the released files. As expanding them with Git is not that simple (it could be done with git archive and export-subst attribute) and there are not many benefits in having them in the first place, just remove all these lines. If nothing else, this will make an eventual transition to Git simpler. Closes #14487. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@74602 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
138 lines
4.5 KiB
C
138 lines
4.5 KiB
C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: chartype.h
|
|
// Purpose: interface of global functions
|
|
// Author: wxWidgets team
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
/** @addtogroup group_funcmacro_string */
|
|
//@{
|
|
|
|
/**
|
|
This macro can be used with character and string literals (in other words,
|
|
@c 'x' or @c "foo") to automatically convert them to wide strings in Unicode
|
|
builds of wxWidgets. This macro simply returns the value passed to it
|
|
without changes in ASCII build. In fact, its definition is:
|
|
|
|
@code
|
|
#ifdef UNICODE
|
|
# define wxT(x) L##x
|
|
#else // !Unicode
|
|
# define wxT(x) x
|
|
#endif
|
|
@endcode
|
|
|
|
Note that since wxWidgets 2.9.0 you shouldn't use wxT() anymore in your
|
|
program sources (it was previously required if you wanted to support Unicode).
|
|
|
|
@see @ref overview_unicode, wxS()
|
|
|
|
@header{wx/chartype.h}
|
|
*/
|
|
#define wxT(string)
|
|
|
|
/**
|
|
Compatibility macro which expands to wxT() in wxWidgets 2 only.
|
|
|
|
This macro can be used in code which needs to compile with both
|
|
wxWidgets 2 and 3 versions, in places where the wx2 API requires a Unicode string
|
|
(in Unicode build) but the wx3 API only accepts a standard narrow
|
|
string, as in e.g. wxCmdLineEntryDesc structure objects initializers.
|
|
|
|
Example of use:
|
|
@code
|
|
const wxCmdLineEntryDesc cmdLineDesc[] =
|
|
{
|
|
{ wxCMD_LINE_SWITCH, wxT_2("q"), wxT_2("quiet"),
|
|
wxT_2("Don't output verbose messages") },
|
|
wxCMD_LINE_DESC_END
|
|
};
|
|
@endcode
|
|
|
|
Without @c wxT_2 the code above wouldn't compile with wxWidgets 2, but using @c
|
|
wxT instead, it wouldn't compile with wxWidgets 3.
|
|
|
|
@see wxT()
|
|
|
|
@since 2.8.12, 2.9.2
|
|
|
|
@header{wx/chartype.h}
|
|
*/
|
|
#define wxT_2(string)
|
|
|
|
/**
|
|
wxS is a macro which can be used with character and string literals (in other words,
|
|
@c 'x' or @c "foo") to convert them either to wide characters or wide strings
|
|
in @c wchar_t-based (UTF-16) builds, or to keep them unchanged in @c char-based
|
|
(UTF-8) builds.
|
|
|
|
Basically this macro produces characters or strings of type wxStringCharType.
|
|
|
|
The use of this macro is optional as the translation will always be done at
|
|
run-time even if there is a mismatch between the kind of the literal used
|
|
and the string or character type used in the current build.
|
|
However using it can be beneficial in <b>performance-sensitive code</b> to
|
|
do the conversion at compile-time instead.
|
|
|
|
@see @ref overview_unicode, wxT()
|
|
|
|
@header{wx/chartype.h}
|
|
*/
|
|
#define wxS(string)
|
|
|
|
/**
|
|
This macro is exactly the same as wxT() and is defined in wxWidgets simply
|
|
because it may be more intuitive for Windows programmers as the standard
|
|
Win32 headers also define it (as well as yet another name for the same
|
|
macro which is _TEXT()).
|
|
|
|
Don't confuse this macro with _()!
|
|
|
|
Note that since wxWidgets 2.9.0 the use of _T() is discouraged just like
|
|
for wxT() and also that this macro may conflict with identifiers defined in
|
|
standard headers of some compilers (such as Sun CC) so its use should
|
|
really be avoided.
|
|
|
|
@header{wx/chartype.h}
|
|
*/
|
|
#define _T(string)
|
|
|
|
/**
|
|
wxChar is defined to be
|
|
\- @c char when <tt>wxUSE_UNICODE==0</tt>
|
|
\- @c wchar_t when <tt>wxUSE_UNICODE==1</tt> (the default).
|
|
*/
|
|
typedef wxUSE_UNICODE_dependent wxChar;
|
|
|
|
/**
|
|
wxSChar is defined to be
|
|
\- <tt>signed char</tt> when <tt>wxUSE_UNICODE==0</tt>
|
|
\- @c wchar_t when <tt>wxUSE_UNICODE==1</tt> (the default).
|
|
*/
|
|
typedef wxUSE_UNICODE_dependent wxSChar;
|
|
|
|
/**
|
|
wxUChar is defined to be
|
|
\- <tt>unsigned char</tt> when <tt>wxUSE_UNICODE==0</tt>
|
|
\- @c wchar_t when <tt>wxUSE_UNICODE==1</tt> (the default).
|
|
*/
|
|
typedef wxUSE_UNICODE_dependent wxUChar;
|
|
|
|
/**
|
|
wxStringCharType is defined to be:
|
|
\- @c char when <tt>wxUSE_UNICODE==0</tt>
|
|
\- @c char when <tt>wxUSE_UNICODE_WCHAR==0</tt> and <tt>wxUSE_UNICODE==1</tt>
|
|
\- @c wchar_t when <tt>wxUSE_UNICODE_WCHAR==1</tt> and <tt>wxUSE_UNICODE==1</tt>
|
|
|
|
The @c wxUSE_UNICODE_WCHAR symbol is defined to @c 1 when building on
|
|
Windows while it's defined to @c 0 when building on Unix, Linux or OS X.
|
|
(Note that @c wxUSE_UNICODE_UTF8 symbol is defined as the opposite of
|
|
@c wxUSE_UNICODE_WCHAR.)
|
|
|
|
Note that wxStringCharType (as the name says) is the type used by wxString
|
|
for internal storage of the characters.
|
|
*/
|
|
typedef wxUSE_UNICODE_WCHAR_dependent wxStringCharType;
|
|
|
|
//@}
|