X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2edb0bdef6238c8c246b6978bc14828b7033d931..9e70eb3b1d349c67224c14e6cc5b2cb5ebd26173:/docs/latex/wx/encconv.tex diff --git a/docs/latex/wx/encconv.tex b/docs/latex/wx/encconv.tex index 39e14fbfd9..e5c2e0f021 100644 --- a/docs/latex/wx/encconv.tex +++ b/docs/latex/wx/encconv.tex @@ -5,9 +5,20 @@ \section{\class{wxEncodingConverter}}\label{wxencodingconverter} -This class is capable of converting strings between any two +This class is capable of converting strings between two 8-bit encodings/charsets. It can also convert from/to Unicode (but only -if you compiled wxWindows with wxUSE\_WCHAR\_T set to 1). +if you compiled wxWindows with wxUSE\_WCHAR\_T set to 1). Only limited subset +of encodings in supported by wxEncodingConverter: +{\tt wxFONTENCODING\_ISO8859\_1..15}, {\tt wxFONTENCODING\_CP1250..1257} and +{\tt wxFONTENCODING\_KOI8}. + +\wxheading{Note} + +Please use \helpref{wxMBConv classes}{mbconvclasses} instead +if possible. \helpref{wxCSConv}{wxcsconv} has much better support for various +encodings than wxEncodingConverter. wxEncodingConverter is useful only +if you rely on {\tt wxCONVERT\_SUBSTITUTE} mode of operation (see +\helpref{Init}{wxencodingconverterinit}). \wxheading{Derived from} @@ -61,33 +72,33 @@ as input string. \wxheading{Return value} -FALSE if given conversion is impossible, TRUE otherwise +false if given conversion is impossible, true otherwise (conversion may be impossible either if you try to convert to Unicode with non-Unicode build of wxWindows or if input or output encoding is not supported.) \membersection{wxEncodingConverter::Convert}\label{wxencodingconverterconvert} -\func{void}{Convert}{\param{const char* }{input}, \param{char* }{output}} +\constfunc{void}{Convert}{\param{const char* }{input}, \param{char* }{output}} -\func{void}{Convert}{\param{const wchar\_t* }{input}, \param{wchar\_t* }{output}} +\constfunc{void}{Convert}{\param{const wchar\_t* }{input}, \param{wchar\_t* }{output}} -\func{void}{Convert}{\param{const char* }{input}, \param{wchar\_t* }{output}} +\constfunc{void}{Convert}{\param{const char* }{input}, \param{wchar\_t* }{output}} -\func{void}{Convert}{\param{const wchar\_t* }{input}, \param{char* }{output}} +\constfunc{void}{Convert}{\param{const wchar\_t* }{input}, \param{char* }{output}} Convert input string according to settings passed to \helpref{Init}{wxencodingconverterinit} and writes the result to {\it output}. -\func{void}{Convert}{\param{char* }{str}} +\constfunc{void}{Convert}{\param{char* }{str}} -\func{void}{Convert}{\param{wchar\_t* }{str}} +\constfunc{void}{Convert}{\param{wchar\_t* }{str}} Convert input string according to settings passed to \helpref{Init}{wxencodingconverterinit} in-place, i.e. write the result to the same memory area. -\func{wxString}{Convert}{\param{const wxString\& }{input}} +\constfunc{wxString}{Convert}{\param{const wxString\& }{input}} Convert wxString and return new wxString object.