【QT小记】QT中QString与常用字符编码转换

前言

记录在使用QString的过程中与常用字符编码的转换方法以及乱码的可能原因和解决方法

例子

字符串	编码方式	十六进制
林	Unicode	0x6797
	GBK	0xC1D6
	UTF8	0xE69E97

QString的字符编码

• QString字符串内部使用的是Unicode编码的方式

QString name = QString("林柒");  //Unicode编码

• 获取QString对应的Unicode编码

QString name = QString("林柒");
QChar *data = name.data();
while (!data->isNull()) {
    qDebug() << "unicode: " << QString::number(data->unicode(), 16);  //转化成16进制显示
    ++data;
}

// 输出结果
unicode:  "6797"
unicode:  "67d2"

QString与GBK编码的转换

// QString转GBK编码
QByteArray QString::toLocal8Bit() const

// GBK编码转QString
QString fromLocal8Bit(const char *str, int size = -1)
QString fromLocal8Bit(const QByteArray &str)

// 测试
QString name = QString("林");
QByteArray gbk = name.toLocal8Bit();
qDebug() << "gbk: " << gbk.toHex();

// 输出结果
gbk:  "c1d6"

注意的是：QString::toLocal8Bit()使用的编码方式是系统本地的编码方式，一般中文window使用的是GBK编码，中文Linux使用的是UTF8编码

QString与UTF8编码的转换

// QString转UTF8编码
QByteArray toUtf8() const

// UTF8编码转QString
QString fromUtf8(const char *str, int size = -1)
QString fromUtf8(const QByteArray &str)

// 测试
QString name = QString("林");
QByteArray utf8 = name.toUtf8();
qDebug() << "utf8: " << utf8.toHex();

// 输出结果
utf8:  "e69e97"

QString与Latin1编码的转换

• Latin1单字节编码
• Latin1是ISO-8859-1的别名，向下兼容ASCII
• 编码范围是0x00-0xFF，0x00-0x7F之间完全和ASCII一致，0x80-0x9F之间是控制字符，0xA0-0xFF之间是文字符号

所以，中文不可以转换为Latin1编码，若转换，则被当成未知字符处理，会被转换成 “?” 字符对应的编码

// QString转Latin1编码
QByteArray toLatin1() const

// Latin1编码转QString
QString fromLatin1(const char *str, int size = -1)
QString fromLatin1(const QByteArray &str)

// 测试
QString name = QString("林");
qDebug() << "from Latin1: " << QString::fromLatin1(name.toLatin1());

// 输出结果
from Latin1:  "?"

中文乱码问题

• 编码方式与解码方式不一致导致乱码

// 测试
QString name = QString("林");
QByteArray gbk = name.toLocal8Bit();
QString gbkStr = QString::fromLocal8Bit(gbk);  //gbk编码，解码方式为gbk
QString utf8Str = QString::fromUtf8(gbk);      //gbk编码，解码方式为utf8
qDebug() << "gbkStr: " << gbkStr;
qDebug() << "utf8Str: " << utf8Str;

// 输出结果
gbkStr:  "林"
utf8Str:  "??"

• 界面显示中文乱码
  • 看飞扬青云大佬的Demo都会在main函数里面写这段代码设置全局编码方式

#if (QT_VERSION < QT_VERSION_CHECK(5,0,0))  //判断QT版本
#if _MSC_VER  //判断是否为MSVC编译器
    QTextCodec *codec = QTextCodec::codecForName("gbk");    //获取GBK编解码器
#else
    QTextCodec *codec = QTextCodec::codecForName("utf-8");  //获取UTF8编解码器
#endif
    QTextCodec::setCodecForLocale(codec);
    QTextCodec::setCodecForCStrings(codec);
    QTextCodec::setCodecForTr(codec);
#else
    QTextCodec *codec = QTextCodec::codecForName("utf-8");
    QTextCodec::setCodecForLocale(codec);
#endif

• 几个函数的作用

// 在由const char * 隐式或显示转换成QString时使用codec编码
QTextCodec::setCodecForCStrings(codec);

// 在使用QObject::tr()接口将const char * 转换成QString时使用codec编码
QTextCodec::setCodecForTr(codec);

// 设置当前系统所用编码为codec（一般中文window使用的是GBK编码，中文Linux使用的是UTF8编码）
QTextCodec::setCodecForLocale(codec);

UTF8编码与GBK编码的互相转换

• 使用QTextCodec

QByteArray LQHelper::utf8ToGbk(const QByteArray &utf8)
{
    // utf8 -> unicode -> gbk
    QTextCodec *utf8Codec = QTextCodec::codecForName("UTF-8");
    QString unicode = utf8Codec->toUnicode(utf8);

    QTextCodec *gbkCodec = QTextCodec::codecForName("GBK");
    QByteArray gbk = gbkCodec->fromUnicode(unicode);

    return gbk;
}

QByteArray LQHelper::gbkToUtf8(const QByteArray &gbk)
{
    // gbk -> unicode -> utf8
    QTextCodec *gbkCodec = QTextCodec::codecForName("GBK");
    QString unicode = gbkCodec->toUnicode(gbk);

    QTextCodec *utf8Codec = QTextCodec::codecForName("UTF-8");
    QByteArray utf8 = utf8Codec->fromUnicode(unicode);

    return utf8;
}

学习资料

• QT帮助文档
• 飞扬青云大佬博客