QTextCodec Class

QByteArray encodedString = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QString string = codec->toUnicode(encodedString);

QString string = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QByteArray encodedString = codec->fromUnicode(string);

QTextCodec *codec = QTextCodec::codecForName("Shift-JIS");
QTextDecoder *decoder = codec->makeDecoder();

QString string;
while (new_data_available()) {
    QByteArray chunk = get_new_data();
    string += decoder->toUnicode(chunk);
}
delete decoder;

成员函数文档

[protected] QTextCodec::QTextCodec()

创建一个 QTextCodec 对象，并赋予其最高优先级。QTextCodec 对象应始终在堆上创建（即使用 `new`）。Qt 将持有该对象的所有权，并在应用程序终止时将其删除。

[virtual noexcept protected] QTextCodec::~QTextCodec()

销毁QTextCodec 。请注意，您不应自行删除编解码器：一旦创建，它们就由Qt负责管理。

警告：此函数不具备可重入性。

[virtual] QList<QByteArray> QTextCodec::aliases() const

子类可以返回该编解码器的多个别名。

编解码器的标准别名可在IANA 字符集编码文件中找到。

[static] QList<QByteArray> QTextCodec::availableCodecs()

按名称返回所有可用编解码器的列表。调用QTextCodec::codecForName()可获取该名称对应的QTextCodec 。

如果某个编解码器有别名，则列表中可能会多次出现该编解码器。

注意：此函数是线程安全的。

另请参阅 availableMibs()、name() 和aliases()。

[static] QList<int> QTextCodec::availableMibs()

返回所有可用编解码器的MIB列表。调用QTextCodec::codecForMib()可获取该MIB的QTextCodec 。

注意：此函数是线程安全的。

另请参阅 availableCodecs() 和mibEnum()。

bool QTextCodec::canEncode(QChar ch) const

如果 Unicode 字符ch 能够使用此编解码器完全编码，则返回true ；否则返回false 。

bool QTextCodec::canEncode(QStringView s) const

如果 Unicode 字符串s 能够使用此编解码器完全编码，则返回true ；否则返回false 。

bool QTextCodec::canEncode(const QString &s) const

s 包含待测试的字符串，用于检查其是否可编码。

[static] QTextCodec *QTextCodec::codecForHtml(const QByteArray &ba, QTextCodec *defaultCodec)

尝试通过检查 BOM（字节顺序标记）和 content-type 元标头，来检测给定字节数组（ba ）中提供的 HTML 片段的编码，并返回一个能够将 HTML 解码为 Unicode 的QTextCodec 实例。如果无法从提供的内容中检测到编码，则返回defaultCodec 。

另请参阅 codecForUtfText()。

[static] QTextCodec *QTextCodec::codecForHtml(const QByteArray &ba)

尝试通过检查 BOM（字节顺序标记）和 content-type 元数据标头，来检测给定字节数组（ba ）中提供的 HTML 片段的编码，并返回一个能够将 HTML 解码为 Unicode 的QTextCodec 实例。如果无法检测到编码，此重载将返回一个 Latin-1 格式的QTextCodec 对象。

[static] QTextCodec *QTextCodec::codecForLocale()

返回指向最适合此区域设置的编解码器的指针。

如果正在使用 ICU 后端，则从 ICU 中获取该编解码器；否则，可能通过操作系统特定的 API 获取。在后一种情况下，该编解码器的名称可能是“System”。

注意：此函数是线程安全的。

另请参阅 setCodecForLocale()。

[static] QTextCodec *QTextCodec::codecForMib(int mib)

返回与MIBenum mib 匹配的QTextCodec 。

注意：此函数是线程安全的。

[static] QTextCodec *QTextCodec::codecForName(const QByteArray &name)

搜索所有已安装的QTextCodec 对象，并返回与name 最匹配的一个；匹配时不区分大小写。如果找不到名称为name 的编解码器，则返回nullptr 。

注意：此函数是线程安全的。

[static] QTextCodec *QTextCodec::codecForName(const char *name)

搜索所有已安装的QTextCodec 对象，并返回与name 最匹配的一个；匹配时不区分大小写。如果找不到与名称name 匹配的编解码器，则返回nullptr 。

[static] QTextCodec *QTextCodec::codecForUtfText(const QByteArray &ba, QTextCodec *defaultCodec)

尝试通过 BOM（字节顺序标记）检测给定代码片段ba 的编码，并返回一个能够将文本解码为 Unicode 的 `QTextCodec ` 实例。该函数可检测以下编码格式之一：

• UTF-32 小端序
• UTF-32 大端序
• UTF-16 小端序
• UTF-16 小端
• UTF-8

如果无法从提供的内容中检测到编解码器，则返回defaultCodec 。

另请参阅 codecForHtml()。

[static] QTextCodec *QTextCodec::codecForUtfText(const QByteArray &ba)

尝试通过 BOM（字节顺序标记）检测所提供代码片段ba 的编码，并返回一个能够将文本解码为 Unicode 的QTextCodec 实例。该函数可检测以下编码格式之一：

• UTF-32 小端序
• UTF-32 大端字节序
• UTF-16 小端序
• UTF-16 小端
• UTF-8

如果无法从提供的内容中检测到编解码器，则该重载函数将返回 Latin-1 编码的 `QTextCodec`。

另请参阅 codecForHtml()。

[pure virtual protected] QByteArray QTextCodec::convertFromUnicode(const QChar *input, int number, int *state) const

QTextCodec 子类必须重新实现此函数。

将input 数组中前number 个字符从Unicode转换为子类的编码，并将结果返回至QByteArray 中。

state 可能为nullptr ，此时转换为无状态操作，应使用默认转换规则。如果state 不是nullptr ，则编解码器应在转换后将状态保存到state 中，并调整该结构体的remainingChars 和invalidChars 成员。

[pure virtual protected] QString QTextCodec::convertToUnicode(const char *chars, int len, int *state) const

QTextCodec 子类必须重新实现此函数。

将chars 中的前len 个字符从子类的编码转换为Unicode，并将结果返回为QString 。

state 参数可以是nullptr ，此时转换为无状态转换，应使用默认转换规则。如果state 不是nullptr ，则编解码器应在转换后将状态保存到state 中，并调整该结构体的remainingChars 和invalidChars 成员。

QByteArray QTextCodec::fromUnicode(const QString &str) const

将str 从Unicode转换为本编解码器的编码格式，并将结果返回至QByteArray 中。

QByteArray QTextCodec::fromUnicode(const QChar *input, int number, int *state = nullptr) const

将input 数组中前number 个字符从Unicode转换为本编解码器的编码，并将结果返回至QByteArray 中。

所用转换器的state 将被更新。

QByteArray QTextCodec::fromUnicode(QStringView str) const

将str 从Unicode转换为本编解码器的编码格式，并将结果返回至QByteArray 中。

QTextDecoder *QTextCodec::makeDecoder(int flags = DefaultConversion) const

创建一个QTextDecoder 对象，并指定flags ，用于解码char * 格式的数据块，从而生成Unicode数据块。

调用方负责删除返回的对象。

QTextEncoder *QTextCodec::makeEncoder(int flags = DefaultConversion) const

创建一个QTextEncoder ，其flags 参数指定为将Unicode数据块编码为char * 数据。

调用方负责删除返回的对象。

[pure virtual] int QTextCodec::mibEnum() const

QTextCodec 的子类必须重新实现此函数。该函数返回 MIBenum 类型（更多信息请参见IANA 字符集编码文件）。重要的是，每个QTextCodec 子类都必须为此函数返回正确的唯一值。

[pure virtual] QByteArray QTextCodec::name() const

QTextCodec 子类必须重新实现此函数。它返回子类所支持的编码名称。

如果该编解码器已在IANA 字符集编码文件中作为字符集注册，则该方法应返回该编解码器的首选 MIME 名称（如果已定义），否则返回其名称。

[static] void QTextCodec::setCodecForLocale(QTextCodec *c)

将编解码器设置为c ；这将由codecForLocale()返回。如果c 的值为nullptr ，则编解码器将重置为默认值。

对于某些希望使用自身机制设置区域设置的应用程序，这可能是有必要的。

警告：此函数不具备可重入性。

另请参阅 codecForLocale()。

QString QTextCodec::toUnicode(const QByteArray &a) const

将a 从该编解码器的编码转换为Unicode，并将结果返回至QString 中。

QString QTextCodec::toUnicode(const char *input, int size, int *state = nullptr) const

将input 中前size 个字符从该编解码器的编码转换为Unicode，并将结果返回至QString 中。

所用转换器的state 字段将被更新。

QString QTextCodec::toUnicode(const char *chars) const

chars 包含源字符。