X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/f1d5aa1285e4419a067815974b5bad2a1d76c747..cf737db6572385131ef0d34041566489b631c3f9:/interface/wx/encconv.h diff --git a/interface/wx/encconv.h b/interface/wx/encconv.h index f7e477d80c..7bf0a48c53 100644 --- a/interface/wx/encconv.h +++ b/interface/wx/encconv.h @@ -3,29 +3,27 @@ // Purpose: interface of wxEncodingConverter // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** @class wxEncodingConverter 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 wxWidgets - with @c wxUSE_WCHAR_T set to 1). + It can also convert from/to Unicode. Only a limited subset of encodings is supported by wxEncodingConverter: @c wxFONTENCODING_ISO8859_1..15, @c wxFONTENCODING_CP1250..1257 and @c wxFONTENCODING_KOI8. @note - Please use wxMBConv classes instead if possible. wxCSConv has much better support for various encodings than wxEncodingConverter. wxEncodingConverter is useful only if you rely on wxCONVERT_SUBSTITUTE mode of operation (see wxEncodingConverter::Init()). @library{wxbase} - @category{misc} + @category{conv} @see wxFontMapper, wxMBConv, @ref overview_nonenglish */ @@ -65,9 +63,6 @@ public: considered a lossless operation. @note You must call Init() before using this method! - - @note wchar_t versions of the method are not available if wxWidgets was - compiled with @c wxUSE_WCHAR_T set to 0. */ bool Convert(const char* input, char* output) const; bool Convert(const wchar_t* input, wchar_t* output) const; @@ -75,12 +70,23 @@ public: bool Convert(const wchar_t* input, char* output) const; /** - Convert input string according to settings passed to Init() in-place, - i.e. write the result to the same memory area. + Convert input string according to settings passed to Init() in-place. + + With this overload, the conversion result is written to the same memory + area from which the input is read. See the Convert(const char*,char*) const overload for more info. */ bool Convert(char* str) const; + + /** + Convert input string according to settings passed to Init() in-place. + + With this overload, the conversion result is written to the same memory + area from which the input is read. + + See the Convert(const wchar_t*,wchar_t*) const overload for more info. + */ bool Convert(wchar_t* str) const; /**