QTextCodec Class 参考手册
| 主页 · 所有的命名空间 · 所有的类 · 主要的类 · 分组的类 · 模块 · 函数 | 汉化人员及日志 |
QTextCodec Class 参考手册
[QtCore module]
QTextCodec类提供了文字编码转换. More...
#include <QTextCodec>
Note: 此类所有函数可 重载, 除了 setCodecForTr(), setCodecForCStrings(), QTextCodec(), 和 ~QTextCodec().
- List of all members, including inherited members
- Qt 3 support members
Public Types
- class ConverterState
- enum ConversionFlag { DefaultConversion, ConvertInvalidToNull, IgnoreHeader }
- flags ConversionFlags
Public Functions
- virtual QList<QByteArray> aliases () const
- bool canEncode ( QChar ch ) const
- bool canEncode ( const QString & s ) const
- QByteArray fromUnicode ( const QString & str ) const
- QByteArray fromUnicode ( const QChar * input, int number, ConverterState * state = 0 ) const
- QTextDecoder * makeDecoder () const
- QTextEncoder * makeEncoder () const
- virtual int mibEnum () const = 0
- virtual QByteArray name () const = 0
- QString toUnicode ( const QByteArray & a ) const
- QString toUnicode ( const char * input, int size, ConverterState * state = 0 ) const
- QString toUnicode ( const char * chars ) const
Static Public Members
- QList<QByteArray> availableCodecs ()
- QList<int> availableMibs ()
- QTextCodec * codecForCStrings ()
- QTextCodec * codecForHtml ( const QByteArray & ba, QTextCodec * defaultCodec )
- QTextCodec * codecForHtml ( const QByteArray & ba )
- QTextCodec * codecForLocale ()
- QTextCodec * codecForMib ( int mib )
- QTextCodec * codecForName ( const QByteArray & name )
- QTextCodec * codecForName ( const char * name )
- QTextCodec * codecForTr ()
- void setCodecForCStrings ( QTextCodec * codec )
- void setCodecForLocale ( QTextCodec * c )
- void setCodecForTr ( QTextCodec * c )
Protected Functions
- QTextCodec ()
- virtual ~QTextCodec ()
- virtual QByteArray convertFromUnicode ( const QChar * input, int number, ConverterState * state ) const = 0
- virtual QString convertToUnicode ( const char * chars, int len, ConverterState * state ) const = 0
详细说明
QTextCodec类提供文字之间的编码转换.
Qt 使用 Unicode 存储, 操作字符串. 在许多情况下，你可能希望使用不懂得编码来处理数据. 例如, 大多数Japanese文档仍用Shift-JIS or ISO 2022-JP存储, 然而Russian用户常用KOI8-R or Windows-1251.
Qt 提供了一套QTextCodec类去帮助转换非-Unicode格式到Unicode.你也可以创建你自己的编码类.
支持的编码有:
- Apple Roman
- Big5
- Big5-HKSCS
- CP949
- EUC-JP
- EUC-KR
- GB18030-0
- IBM 850
- IBM 866
- IBM 874
- ISO 2022-JP
- ISO 8859-1 to 10
- ISO 8859-13 to 16
- Iscii-Bng, Dev, Gjr, Knd, Mlm, Ori, Pnj, Tlg, and Tml
- JIS X 0201
- JIS X 0208
- KOI8-R
- KOI8-U
- MuleLao-1
- ROMAN8
- Shift-JIS
- TIS-620
- TSCII
- UTF-8
- UTF-16
- UTF-16BE
- UTF-16LE
- UTF-32
- UTF-32BE
- UTF-32LE
- Windows-1250 to 1258
- WINSAMI2
QTextCodecs常被用来将本地的编码转换为Unicode.假设你有些Russian KOI8-R编码的字串,希望转换为Unicode. 最简单的方法如下:
QByteArray encodedString = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QString string = codec->toUnicode(encodedString);
执行完后, string 保存了转换为Unicode的文本. 将Unicode字串转换为本地编码同样简单:
QString string = "...";
QTextCodec *codec = QTextCodec::codecForName("KOI8-R");
QByteArray encodedString = codec->fromUnicode(string);
陆续读或写各种编码, 使用 QTextStream 和它的 setCodec() 函数. 查看QTextCodec向文件I/O读写的范例Codecs.
当试图转换块数据时应当注意,例如,从网络获取的数据.这种情况，可能将多字节字符分成几块. 将会导致丢失字符甚至全部转换失败.
在类似这种情况下使用QTextDecoder 对象来编码和使用 QTextDecoder 来完成整个译码过程, 如下:
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);
}
The QTextDecoder对象保存了块与块之间的状态所以即使多个字节的字符被分成多块也能正常工作.
创建你自己的编码类
创建QTextCodec子类可以为Qt添加新的文字编码支持.
The pure virtual functions describe the encoder to the system and the coder is used as required in the different text file formats supported by QTextStream, and under X11, for the locale-specific character input and output.
向Qt添加新的编码支持，需要创建QTextCodec子类，并实现下表的函数.
| Function | Description |
|---|---|
| name() | 返回正式编码的名称. 如果编码在 IANA character-sets encoding file中, the name 将为编码首选MIME name. |
| aliases() | 返回编码的别名. QTextCodec提供了默认实现返回一个空列表. 如, "ISO-8859-1" has "latin1", "CP819", "IBM819", and "iso-ir-100" as aliases. |
| mibEnum() | 如果编码在 IANA character-sets encoding file中，则返回MIB枚举类型. |
| convertToUnicode() | 将8位字符串转换为Unicode. |
| convertFromUnicode() | 将Unicode转换为8位字符串. |
你将发现为你的编码创建一个插件更方便; 查看 How to Create Qt Plugins 获取详细信息.
See also QTextStream, QTextDecoder, QTextEncoder, and Codecs Example.
Member Type Documentation
enum QTextCodec::ConversionFlag
flags QTextCodec::ConversionFlags
| Constant | Value | Description |
|---|---|---|
| QTextCodec::DefaultConversion | 0 | No flag is set. |
| QTextCodec::ConvertInvalidToNull | 0x80000000 | 如果此标志被设置，每个无效的输入将被转换为null字符输出. |
| QTextCodec::IgnoreHeader | 0x1 | 忽略所有的Unicode字节序. |
The ConversionFlags type is a typedef for QFlags<ConversionFlag>. It stores an OR combination of ConversionFlag values.
Member Function Documentation
QTextCodec::QTextCodec () [protected]
构造一个QTextCodec, 并且赋予最高的优先级. QTextCodec 应在堆上构造 (i.e. 使用 new关键字). Qt 获取所有权并在应用程序结束时删除.
Warning: 此函数不可 重载 .
QTextCodec::~QTextCodec () [virtual protected]
析构QTextCodec. 注意你不应该自己删除codecs:一旦创建便由Qt负责.
Warning: 此函数不可 重载 .
QList<QByteArray> QTextCodec::aliases () const [virtual]
子类返回别名序列
编码标准别名可以查看 IANA character-sets encoding file.
QList<QByteArray> QTextCodec::availableCodecs () [static]
返回所有可用的编码, 调用 QTextCodec::codecForName()通过name获得QTextCodec的name.
如果编码有别名，立标将包含许多提及的相同编码.
See also availableMibs(), name(), and aliases().
QList<int> QTextCodec::availableMibs () [static]
为多有可用的编码返回MIBs列表. Call QTextCodec::codecForMib() to obtain the QTextCodec for the MIB.
See also availableCodecs() and mibEnum().
翻译了部分Qt4.5的参考手册，详细地址：http://l.99081.com/jieen/Qt451/index.html
刚开始，慢慢来！坚持