X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/751731864888f00e31e6dce1092ac28a1fac5358..21dc4be5d27fd73cda55795ab9d1e7e02b494c46:/docs/latex/wx/encconv.tex diff --git a/docs/latex/wx/encconv.tex b/docs/latex/wx/encconv.tex index a0a4e96c21..312e47216a 100644 --- a/docs/latex/wx/encconv.tex +++ b/docs/latex/wx/encconv.tex @@ -85,7 +85,7 @@ or output encoding is not supported.) \func{static bool}{CanConvert}{\param{wxFontEncoding}{encIn}, \param{wxFontEncoding }{encOut}} Return true if (any text in) multibyte encoding \arg{encIn} can be converted to -another one ({\it{encOut}}) losslessly. +another one ({\it encOut}) losslessly. Do not call this method with \texttt{wxFONTENCODING\_UNICODE} as either parameter, it doesn't make sense (always works in one sense and always depends @@ -94,25 +94,31 @@ on the text to convert in the other). \membersection{wxEncodingConverter::Convert}\label{wxencodingconverterconvert} -\constfunc{void}{Convert}{\param{const char* }{input}, \param{char* }{output}} +\constfunc{bool}{Convert}{\param{const char* }{input}, \param{char* }{output}} -\constfunc{void}{Convert}{\param{const wchar\_t* }{input}, \param{wchar\_t* }{output}} +\constfunc{bool}{Convert}{\param{const wchar\_t* }{input}, \param{wchar\_t* }{output}} -\constfunc{void}{Convert}{\param{const char* }{input}, \param{wchar\_t* }{output}} +\constfunc{bool}{Convert}{\param{const char* }{input}, \param{wchar\_t* }{output}} -\constfunc{void}{Convert}{\param{const wchar\_t* }{input}, \param{char* }{output}} +\constfunc{bool}{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}. -\constfunc{void}{Convert}{\param{char* }{str}} +\constfunc{bool}{Convert}{\param{char* }{str}} -\constfunc{void}{Convert}{\param{wchar\_t* }{str}} +\constfunc{bool}{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. +All of the versions above return \true if the conversion was lossless and +\false if at least one of the characters couldn't be converted and was replaced +with {\tt '?'} in the output. Note that if {\tt wxCONVERT\_SUBSTITUTE} was +passed to \helpref{Init}{wxencodingconverterinit}, substitution is considered +lossless operation. + \constfunc{wxString}{Convert}{\param{const wxString\& }{input}} Convert wxString and return new wxString object.