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-1QTextCodec 。

[static] QTextCodec *QTextCodec::codecForLocale()

返回最适合此本地的编解码器指针。

如果使用的是 ICU 后端，编解码器将从 ICU 获取，否则可能从操作系统特定的 API 获取。在后一种情况下，编解码器的名称可能是 "System"。

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

另请参见 setCodecForLocale()。

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

返回与MIBenum 匹配的QTextCodec mib 。

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

[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 Little Endian
• UTF-32 Big Endian
• UTF-16 小端码
• UTF-16 Big Endian
• UTF-8

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

另请参阅 codecForHtml().

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

这是一个重载函数。

尝试使用 BOM（字节序号）检测所提供片段ba 的编码，并返回一个能将文本解码为 unicode 的QTextCodec 实例。该函数可检测以下编码之一：

• UTF-32 Little Endian
• UTF-32 Big Endian
• UTF-16 小端码
• UTF-16 Big Endian
• UTF-8

如果无法从所提供的内容中检测到编解码器，此重载将返回一个 Latin-1QTextCodec 。

另请参阅 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

用指定的flags 创建QTextDecoder ，对char * 数据块进行解码，以创建 Unicode 数据块。

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

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

用指定的flags 创建QTextEncoder ，将 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 包含源字符。