Slightly improve wxMBConv::IsUTF8() documentation

Mention that this method is supposed to be used only as an optimization
and also mention that it hadn't been universally available until 3.1.1.

See https://github.com/wxWidgets/wxWidgets/pull/570
This commit is contained in:
Vadim Zeitlin
2017-10-28 01:10:51 +02:00
parent fe77b2d593
commit bb949e9847

View File

@@ -69,9 +69,15 @@ public:
static size_t GetMaxMBNulLen(); static size_t GetMaxMBNulLen();
/** /**
return true if the converter's charset is UTF-8, i.e. char* strings Return true if the converter's charset is UTF-8.
decoded using this object can be directly copied to wxString's internal
storage without converting to WC and than back to UTF-8 MB string This is provided to optimize creating wxStrings from the @c char*
strings returned by this converter, as they can be directly used with
wxString::FromUTF8() or even wxString::FromUTF8Unchecked() when this
method returns @true.
This function is universally available since wxWidgets 3.1.1 (it was
previously only available in some of the build configurations).
*/ */
virtual bool IsUTF8() const; virtual bool IsUTF8() const;