From 5d1b211aba44a2a6758aa124027c365d7584ab9a Mon Sep 17 00:00:00 2001 From: Thiago Macieira Date: Tue, 9 Apr 2024 21:34:01 -0700 Subject: [PATCH] QStringConverter/Doc: add more details about additional codecs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fixes: QTBUG-124221 Change-Id: If1bf59ecbe014b569ba1fffd17c4d113d02425eb Reviewed-by: Fabian Kosmale Reviewed-by: MÃ¥rten Nordheim (cherry picked from commit 71e87993d6bb9c3bf61883d66f97a5e0cfa2bfb1) Reviewed-by: Qt Cherry-pick Bot --- src/corelib/text/qstringconverter.cpp | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/src/corelib/text/qstringconverter.cpp b/src/corelib/text/qstringconverter.cpp index fd45ccf2fdd..2041372fda7 100644 --- a/src/corelib/text/qstringconverter.cpp +++ b/src/corelib/text/qstringconverter.cpp @@ -1774,7 +1774,7 @@ static qsizetype toLatin1Len(qsizetype l) { return l + 1; } operation, encoding UTF-16 encoded data (usually in the form of a QString) to the requested encoding. - The supported encodings are: + The following encodings are always supported: \list \li UTF-8 @@ -1788,6 +1788,10 @@ static qsizetype toLatin1Len(qsizetype l) { return l + 1; } \li The system encoding \endlist + QStringConverter may support more encodings depending on how Qt was + compiled. If more codecs are supported, they can be listed using + availableCodecs(). + \l {QStringConverter}s can be used as follows to convert some encoded string to and from UTF-16. @@ -2356,6 +2360,10 @@ static qsizetype availableCodecCount() QStringDecoder's constructor to create a en- or decoder for the given codec. + This function may be used to obtain a listing of additional codecs beyond + the standard ones. Support for additional codecs requires Qt be compiled + with support for the ICU library. + \note The order of codecs is an internal implementation detail and not guaranteed to be stable. */