何处开始呢?
一旦在Qt程序中出现latin1字符集以外的字符,几乎大家无一例外的会用到 QTextCodec。
而不少网友不分青红皂白,一旦用到中文,就同时使用下面3条指令(其中textc 取为 gb18030 或 utf8,还有的会选用system)。
QTextCodec::setCodecForCStrings(textc); QTextCodec::setCodecForTr(textc); QTextCodec::setCodecForLocale(textc);
可是这3个东西有什么用呢?QTextCodec是做什么用的?
字符串、字节流
在C和C++中,我们一般都是将 "hello world!" 这种称为字符串(窄字符串、C传统字符串、char*字符串...)
但目前来说,当我们提字符串时,一般是一个Unicode字符串,其由一个一个的unicode字符构成;当我们提字节流时,是指一个一个的字节。
或许,我们可以说,ANSI C、C++截止目前只有字节流,而缺乏对字符串的支持。
Qt 为字节流和字符串分别提供了 QByteArray 和 QString 两个类(还有QLatin1String等其他类,但这两个是最主要的)。当我们涉及到IO时,比如读写文件、读写网络socket、控制台(终端)输入输出、读写串口... 操作的都是字节流,如果我们此时需要的操作的内容是字符串,则需要二者之间的相互转换。
QTextCodec做什么?
在java、C#、python等语言都内置支持unicode字符串的情况下,C、C++ 一直以来对unicode却没有提供任何直接的支持(尽管有个所谓的宽字符wchar_t,但却不能解决什么问题)。即使是下一代标准(C++0x, C1x),对unicode也只是提供了一部分支持,真...
标准对unicode缺乏支持,各个编译器对编码的支持又严重不一,这对于一个需要unicode字符串而又要夸平台的C++的库Qt来说,还真是一个挑战。Qt为解决这个问题提供了QTextCodec。
QTextCodec 提供的是 字符串 和 字节流 之间的相互转换(也就是字符的编解码)。
为了了解 QTextCodec 究竟是做了什么,我们不妨先定义自己的一个codec看看:
自定义QTextCodec
- 定义一个类似latin1的单字节的字符集
- 共 0~255 这256个码位
- 与latin1相比,只不过是a-z和A-Z都反了一下序
- 比如,对与字节流"\x68\x65\x6c\x6c\x6f\x20\x77\x6f\x72\x6c\x64\x21"
- 按照latin1来解码,则是 u"hello world!"
- 按照我们的自定义编码,则是无意义的 u"svool dliow!"
class DbzhangCodec:public QTextCodec { public: DbzhangCodec(){} ~DbzhangCodec(){} QString convertToUnicode(const char *chars, int len, ConverterState *) const { if (len <= 0 || chars == 0) return QString(); QString r(len); for (int i=0; i<len; ++i) { if (chars[i] > 'a' && chars[i] < 'z') r[i] = 'a' + 'z' - chars[i]; else if (chars[i] > 'A' && chars[i] < 'Z') r[i] = 'A' + 'Z' - chars[i]; else r[i] = QLatin1Char(chars[i]); } return r; } QByteArray convertFromUnicode(const QChar *in, int len, ConverterState *) const { QByteArray r(len, '?'); for (int i=0; i<len; ++i) { int u = in[i].unicode(); if (u > 255) r[i] = '?'; else if (u > 'a' && u < 'z') r[i] = 'z' - u + 'a'; else if (u > 'A' && u < 'Z') r[i] = 'Z' - u + 'A'; else r[i] = u; } return r; } QByteArray name() const {return "dbzhang800";} QList<QByteArray> aliases() const{return QList<QByteArray>()<<"dbzhang-800";} int mibEnum() const{return 2011;} };
这个类主要就是要实现两个函数,一个是字节流到unicode的转换,一个是unicode到字节流的转换。
使用举例
定义了一个自定义的codec,那么如何使用呢?
int main(int argc, char *argv[]) { QCoreApplication a(argc, argv); QTextCodec * codec = new DbzhangCodec; QTextCodec::setCodecForCStrings(codec); qDebug()<<QString("hello world!"); return 0; }
注意:此处使用 new,但却没有相应的 delete。这不会造成内存泄漏,因为Qt创建每一个TextCodec之时都会将其放入到一个QList中,这样当程序退出时,如果该codec尚未销毁,则会被清理。
这个例子中涉及两处字符串和字节流的转换。
- "hello world!" 是字节流,等价于 "\x68\x65\x6c\x6c\x6f\x20\x77\x6f\x72\x6c\x64\x21"
- 将QString和字节流的默认转换编码设置为我们自定义的codec
- 于是,前面的字节流被解码为u"svool dliow!"这样一个unicode字符串
- qDebug输出该字符串时,需要将其编码成字节流?如何编码?是由 QTextCodec::setCodecForLocale 控制的,默认编码为 system
- 于是被编码成 "svool dliow!" 这样的字节流输出。
插件
前面自定义了一个codec,尽管用起来没问题,好像不太正规哈。一般不是要弄个插件出来,然后放到可执行程序所在目录下的codecs子目录下,让程序来自动识别么?
恩,稍微多做一点工作,在前面定义codec的文件中多加一个类:
#include <QTextCodecPlugin> #include <QTextCodec> class DbzhangCodecPlugin : public QTextCodecPlugin { public: DbzhangCodecPlugin() {} QList<QByteArray> names() const {return QList<QByteArray>()<<"dbzhang800";} QList<QByteArray> aliases() const {return QList<QByteArray>()<<"dbzhang-800";} QList<int> mibEnums() const {return QList<int>()<<2011;} QTextCodec *createForMib(int mib) { return mib == 2011 ? new DbzhangCodec : 0; } QTextCodec *createForName(const QByteArray & name) { if (name == "dbzhang800" || name == "dbzhang-800") return new DbzhangCodec; else return 0; } }; Q_EXPORT_PLUGIN2(dbzhangcodec, DbzhangCodecPlugin)
配合一个.pro 文件
TARGET = dbzhangcodec TEMPLATE = lib CONFIG += plugin SOURCES += codecplugin.cpp
然后将生成的动态库放入可执行程序目录下的codecs子目录下。
此时,我们在程序中即可直接使用
QTextCodec * codec = QTextCodec::codecForName("dbzhang800");
setCodecFor****
这3个东西到底是做什么呢?
QTextCodec::setCodecForCStrings(textc); QTextCodec::setCodecForTr(textc); QTextCodec::setCodecForLocale(textc);
3个很简单的东西。字节流 <==> 字符串
setCodecForCStrings
void QTextCodec::setCodecForCStrings ( QTextCodec * codec ) [static] Sets the codec used by QString to convert to and from const char * and QByteArrays. If the codec is 0 (the default), QString assumes Latin-1.
在QString 与中文问题 我们介绍过这个东西。它将影响QString中
- QString ( const char * str )
-
QString ( const QByteArray & ba )
-
QString & append ( const QByteArray & ba )
-
QString & append ( const char * str )
-
bool operator!= ( const QByteArray & other ) const
- bool operator!= ( const char * other ) const
-
QString & operator= ( const QByteArray & ba )
-
QString & operator= ( const char * str )
- QString fromAscii ( const char * str, int size = -1 )
- QString fromAscii ( const char * str, int size = -1 )
- ...
等和字节流(QByteArray或char*)相关但有没有像fromUtf8等那样指定明确编码的成员函数。
以及QByteArray类中涉及unicode字符串的那些成员函数
-
QByteArray & append ( const QString & str )
-
int indexOf ( const QString & str, int from = 0 ) const
-
bool operator< ( const QString & str ) const
- ...
setCodecForTr
void QTextCodec::setCodecForTr ( QTextCodec * c ) [static] Sets the codec used by QObject::tr() on its argument to c. If c is 0 (the default), tr() assumes Latin-1.
在 Qt中translate、tr关系 与中文问题 一文中我们过提到了一个问题。
当我们使用
QString QObject::tr ( const char * sourceText, const char * disambiguation = 0, int n = -1 ) [static]
这种函数时,需要将 sourceText 这个字节流转换成一个QString字符串。
如果我们已经加载了翻译文件,那么Qt将把该字节流作为一个key去查找相应的翻译好的字符串。
如果没有加载翻译文件呢?Qt将需要某个codec将该字节流解码成unicode字符串。
setCodecForLocale
void QTextCodec::setCodecForLocale ( QTextCodec * c ) [static] Set the codec to c; this will be returned by codecForLocale(). If c is a null pointer, the codec is reset to the default. This might be needed for some applications that want to use their own mechanism for setting the locale.
这个应该没什么好说的,在绝大多数情况下,我们在代码中应该都用不到这个函数(默认的system应该比我们所能设置的要好)。
-
当我们从程序的命令行读取参数时int main(int argc, char *argv[])
-
当我们从往控制台输出内容时qDebug()<<QString(...)
- 使用 QString::fromLocal8Bit() 与 QString::toLocal8Bit()
- ...