QTextCodec 类

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;

成员函数文档

[受保护] QTextCodec::QTextCodec()

构建一个 QTextCodec，并赋予它最高的优先级。QTextCodec 应始终在堆上构建（即使用 new）。Qt 承担所有权，并在应用程序结束时删除它。

[虚拟 noexcept 受保护] QTextCodec::~QTextCodec()

销毁 QTextCodec。请注意，你不应该自己删除解码器：一旦创建，它们就成为 Qt 的责任。

警告： 此函数不是 可重入的。

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

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

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

[静态] QList<QByteArray> QTextCodec::availableCodecs()

返回所有可用编解码器的列表，按照名称。调用 QTextCodec::codecForName() 获取指定名称的 QTextCodec。

如果编解码器有别名，列表中可能包含许多有关同一编解码器的提及。

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

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

[静态] QList<int> QTextCodec::availableMibs()

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

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

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

bool QTextCodec::canEncode(QChar ch) const

如果此编解码器可以完全编码 Unicode 字符 ch，则返回 true；否则返回 false。

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

这是一个重载函数。

s 包含正在测试编码能力的字符串。

bool QTextCodec::canEncode(QStringView s) const

这是一个重载函数。

如果 Unicode 字符串 s 可以使用该编解码器完整地编码，则返回 true；否则返回 false。

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

通过检查 BOM（字节顺序标记）和内容类型元标题，尝试在给定的字节数组 ba 中检测提供的 HTML 片段编码，并返回一个可以解码 HTML 为 Unicode 的 QTextCodec 实例。如果无法从提供的内容中检测到编解码器，则返回 defaultCodec。

另请参阅codecForUtfText。

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

这是一个重载函数。

通过检查 BOM（字节顺序标记）和内容类型元标题，尝试在给定的字节数组 ba 中检测提供的 HTML 片段编码，并返回一个可以解码 HTML 为 Unicode 的 QTextCodec 实例。如果无法检测到编解码器，则此重载返回一个 Latin-1 QTextCodec。

[静态] QTextCodec *QTextCodec::codecForLocale()

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

编解码器将从 ICU 背景（如果使用该后端）检索，否则可能从 OS 特定的 API 中获取。在后一种情况下，编解码器的名称可能是“System”。

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

另请参阅setCodecForLocale。

[静态] QTextCodec *QTextCodec::codecForMib(int mib)

返回与 MIBenum mib 匹配的 QTextCodec。

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

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

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

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

[静态] QTextCodec *QTextCodec::codecForName(const char *name)

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

[静态] 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。

[纯虚保护] QByteArray QTextCodec::convertFromUnicode(const QChar *input, int number, QTextCodec::ConverterState *state) const

QTextCodec 的子类必须重写此函数。

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

state 可以是 nullptr，在这种情况下转换是无状态的，应使用默认转换规则。如果 state 不是 nullptr，编解码器应在 state 中保存转换后的状态，并调整结构体中的 remainingChars 和 invalidChars 成员。

[纯虚保护] QString QTextCodec::convertToUnicode(const char *chars, int len, QTextCodec::ConverterState *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(QStringView str) const

这是一个重载函数。

将 str 从 Unicode 转换为该编解码器的编码，并返回结果到一个 QByteArray。

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

将输入数组中的前 number 个字符从 Unicode 转换为该编解码器的编码，并返回结果到一个 QByteArray。

更新了转换器的状态。

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

创建一个具有指定 flags 的 QTextDecoder，以解码 char * 数据块，创建 Unicode 数据块。

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

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

创建一个具有指定 flags 的 QTextEncoder，用于将 Unicode 数据块编码为 char * 数据。

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

[纯虚函数] int QTextCodec::mibEnum() const

QTextCodec 的子类必须重写此函数。返回 MIBenum（有关更多信息，请参阅IANA 字符集编码文件）。对于每个QTextCodec 子类，返回此函数的正确唯一值非常重要。

[纯虚函数] QByteArray QTextCodec::name() const

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

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

[静态] 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 *chars) const

这是一个重载函数。

chars 包含源字符。

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

将 input 的前 size 个字符从此编码的编码转换为 Unicode，并将结果返回到 QString。

更新了转换器的状态。