QStringConverter Class

QByteArray encodedString = "...";
auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);
QString string = toUtf16(encodedString);

QString string = "...";
auto fromUtf16 = QStringEncoder(QStringEncoder::Utf8);
QByteArray encodedString = fromUtf16(string);

auto toUtf16 = QStringDecoder(QStringDecoder::Utf8);

QString string;
while (new_data_available() && !toUtf16.hasError()) {
    QByteArray chunk = get_new_data();
    string += toUtf16(chunk);
}
auto result = toUtf16.finalize();
if (result.error != QStringDecoder::FinalizeResult::Error::NoError) {
    // Handle error
}

成员函数文档

[noexcept default] QStringConverter::QStringConverter(QStringConverter &&)

通过Move构造一个QStringConverter 的实例。

[noexcept protected default] QStringConverter::~QStringConverter()

销毁QStringConverter 的实例。

[static] QStringList QStringConverter::availableCodecs()

返回一个支持的编解码器名称列表。该函数返回的名称可传递给QStringEncoder 和QStringDecoder 的构造函数，以针对给定的编解码器创建编码器或解码器。

此函数可用于获取标准编解码器之外的其他编解码器列表。要支持这些额外编解码器，需要将 Qt 编译为支持 ICU 库。

[static noexcept] std::optional<QStringConverter::Encoding> QStringConverter::encodingForData(QByteArrayView data, char16_t expectedFirstCharacter = 0)

如果能够确定，则返回data 内容的编码。可以将expectedFirstCharacter 作为附加提示传递，以帮助确定编码。

如果编码不明确，则返回的可选值为空。

[static] std::optional<QStringConverter::Encoding> QStringConverter::encodingForHtml(QByteArrayView data)

尝试通过检查开头的字节顺序标记或 HTML meta 标签中的字符集指定符，来确定data 中 HTML 的编码。如果可选参数为空，则QStringConverter 不支持所指定的编码。如果未检测到任何编码，该方法将返回 Utf8。

另请参阅 QStringDecoder::decoderForHtml()。

[static noexcept] std::optional<QStringConverter::Encoding> QStringConverter::encodingForName(QAnyStringView name)

将name 转换为相应的Encoding 成员（如果存在的话）。

如果name 不是 Encoding 枚举中列出的编解码器名称，则返回std::nullopt 。不过，当 Qt 与 ICU 一起构建时，如果 ICU 提供了具有该名称的转换器，QStringConverter 的构造函数仍可能接受此类名称。

[noexcept] bool QStringConverter::hasError() const

如果转换无法正确转换某个字符，则返回 true。例如，这可能是由于无效的 UTF-8 序列，或者由于目标编码的限制导致某个字符无法被转换而触发的。

[noexcept] bool QStringConverter::isValid() const

如果这是一个可用于文本编码或解码的有效字符串转换器，则返回 true。

通过默认构造的字符串转换器，或使用不受支持的名称构造的转换器，均视为无效。

[noexcept] const char *QStringConverter::name() const

返回该QStringConverter 能够进行编码或解码的编码规范名称。如果转换器无效，则返回 nullptr。返回的名称采用 UTF-8 编码。

另请参阅 isValid()。

[static noexcept] const char *QStringConverter::nameForEncoding(QStringConverter::Encoding e)

返回编码e 的规范名称；若e 为无效值，则返回nullptr 。

[noexcept] void QStringConverter::resetState()

重置转换器的内部状态，清除潜在的错误或未完成的转换。

[noexcept default] QStringConverter &QStringConverter::operator=(QStringConverter &&)

将other 通过move赋值给此QStringConverter 实例。