QTextCodec
QTextCodec为文本编码之间提供转换。
Qt用Unicode 来存储,绘制和操作字符串。在很多情况下你可能希望操作不同编码的数据。例如,大部分日本文档是以Shift-JIS或 ISO 2022-JP进行存储,然而俄国用户的文档是以KOI8-R 或 Windows-1251编码的。
Qt提供一组QtextCodec类来实现非Unicode 和Unicode 格式之间的转换。你也可以创建自己的编码解码器。
支持的编码如下:
· Apple Roman
· Big5
· CP949
· EUC-JP
· EUC-KR
· IBM 850
· IBM 866
· IBM 874
· 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
· TIS-620
· TSCII
· UTF-8
· UTF-16
· UTF-16BE
· UTF-16LE
· UTF-32
· UTF-32BE
· UTF-32LE
· Windows-1250 to 1258
如果启用支持Qt与ICU一起编译,ICU支持的大部分编码解码器在程序中也可用。
QTextCodecs 可以像下面一样使用吧本地编码转换为Unicode,假设有一个俄文 KOI8-R编码的字符串,并想把它转为Unicode。简单的做法是:
QByteArray encodedString ="...";
QTextCodec*codec=QTextCodec::codecForName("KOI8-R");
QString string = codec->toUnicode(encodedString);
此后,文本字符串转化为Unicode。把一个Unicode字符串转化为本地编码的字符串也很简单:
QString string ="...";
QTextCodec*codec = QTextCodec::codecForName("KOI8-R");
QByteArray encodedString = codec->fromUnicode(string);
为了用不同的编码进行读写,可以用 QTextStream 及其函数 setCodec() 。
当试图转换数据块时有些是需要注意的,例如,当从网络接收到数据块,这种情况下多字节的字符可能被分在了两个数据块。这时最好只是导致字符的丢失,最坏可能导致转换失败。
在这种情况下的方法是为解码器创建一个 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);
}
delete decoder;
QTextDecoder 对象维护了数据块之间的状态,即使多字节的字符被分在不同的数据块也能正常的工作。
CreatingYour Own Codec Class
Qt支持通过创建QTextCodec 子类添加新的文本编码。
纯虚函数将编码描述到系统,而且在QTextStream支持的不同文本文件格式中,在X11特定字符的输入输出都是需要这个编码解码器的。
为了添加新的编码到Qt,继承 QTextCodec 并重新实现以下函数:
Function |
Description |
name() |
Returns the official name for the encoding. If the encoding is listed in the IANA character-sets encoding file, the name should be the preferred MIME name for the encoding. |
aliases() |
Returns a list of alternative names for the encoding. QTextCodec provides a default implementation that returns an empty list. For example, "ISO-8859-1" has "latin1", "CP819", "IBM819", and "iso-ir-100" as aliases. |
mibEnum() |
Return the MIB enum for the encoding if it is listed in the IANA character-sets encoding file. |
convertToUnicode() |
Converts an 8-bit character string to Unicode. |
convertFromUnicode() |
Converts a Unicode string to an 8-bit character string. |
Member Type Documentation
numQTextCodec::ConversionFlag
flags QTextCodec::ConversionFlags
Constant |
Value |
Description |
QTextCodec::DefaultConversion |
0 |
No flag is set. |
QTextCodec::ConvertInvalidToNull |
0x80000000 |
If this flag is set, each invalid input character is output as a null character. |
QTextCodec::IgnoreHeader |
0x1 |
Ignore any Unicode byte-order mark and don‘t generate any. |
QTranslator
QTranslator 为文本的输出的国际化提供支持。
QTranslator 的对象包含一组从源语言到目标语言的译文。QTranslator 提供函数在翻译文件中查找译文。翻译文件被Qt Linguist.创建的。
QTranslator 最常见的用法是:加载一个翻译未见,用QCoreApplication::installTranslator()安装,并通过QObject::tr()使用它。例如:
int main(intargc,char*argv[])
{
QApplication app(argc, argv);
QTranslator translator;
translator.load("hellotr_la");
app.installTranslator(&translator);
QPushButton hello(QPushButton::tr("Hello world!"));
hello.resize(100,30);
hello.show();
return app.exec();
}
注意:translator 必须在程序的widgets之前创建。
大多数程序不用对该类做其他操作。QTranslator 类提供的其他函数对于操作翻译文件的程序是很有用的。
Lookingup Translations
你可以通过 translate()来查找一个译文。 translate() 接受三个参数:
· context –通常是调用tr()函数的类名
· source text –通常是 tr()参数.
· disambiguation – 一个可选的字符串消除相同文本在相同上下文的不同用法的歧义。
例如,如果程序运行在波兰语环境,在对话框中的 "Cancel" 则有可能变为 "Anuluj"。
上下文就是对话框类名,这通常没有任何意见而且翻译文本为"Anuluj"。
但不总是那么简单的。设置为双面打印和绑定的西班牙版本的打印对话框可能需要"Activado" 和 "Activada" 翻译为"Enabled". 。在这种情况下,源文本在所有情况下都是 "Enabled" ,上下文是对话框类名,但是这两项可能消除歧义,一个 是"two-sided printing" 另外一个则为 "binding" 。消除歧义使得translator 为西班牙版本选择适当的性别,使得Qt能区分译文。
UsingMultiple Translations
在一个程序中可以使用多个翻译文件,译文的查找与安装的顺序相反,所以进行翻译时最近安装的翻译文件最先被查找,最早安装的翻译文件最后被查找。一旦找到译文中包含匹配的字符串就停止查找。
这个机制可以使得特定的译文被选中或优先于别的译文。从程序中卸载translator 只需要把它传给QCoreApplication::removeTranslator() 函数和用QCoreApplication::installTranslator().重新安装。它将成为第一个被查找匹配字符串的译文。
QLocale
在不同的语言中,Qlocale为数字和它们的字符串提供转换。
Qlocale在构造函数由语言/国家对来初始化,并提供数字到字符串和字符串到数字的转换函数。例如:
QLocale egyptian(QLocale::Arabic,QLocale::Egypt);
QString s1 = egyptian.toString(1.571429E+07,‘e‘);
QString s2 = egyptian.toString(10);
double d =egyptian.toDouble(s1);
int i =egyptian.toInt(s2);
QLocale 支持默认的语言环境的概念,它有程序启动的系统设置决定。默认语言环境可以通过静态函数setDefault()来改变。设置默认语言环境有以下影响:
· 如果一个QLocale 对象有默认构造函数生成,则使用的是默认语言环境设置。
· QString::toInt(), QString::toDouble()等函数根据默认语言环境来翻译字符串。如果失败则退回到“C”环境。
· QString::arg()使用默认语言环境来生成格式化数字,如果格式字符串指示的位置包含’L’,如"%L1"
下面的例子说明了如何直接使用QLocale :
QLocale::setDefault(QLocale(QLocale::Hebrew, QLocale::Israel));
QLocale hebrew; // Constructs a default QLocale
QString s1 = hebrew.toString(15714.3,‘e‘);
bool ok;
double d;
QLocale::setDefault(QLocale::C);
d = QString("1234,56").toDouble(&ok); // ok == false
d = QString("1234.56").toDouble(&ok); // ok == true, d == 1234.56
QLocale::setDefault(QLocale::German);
d = QString("1234,56").toDouble(&ok); // ok == true, d == 1234.56
d = QString("1234.56").toDouble(&ok); // ok == true, d == 1234.56
QLocale::setDefault(QLocale(QLocale::English, QLocale::UnitedStates));
str = QString("%1 %L2 %L3")
.arg(12345).arg(12345).arg(12345,0,16);
// str == "12345 12,345 3039"
如果在构造函数中指定语言/国家,下面三件事之一可能发生:
· 如果在数据库中找到语言/国家,那就用它。
· 如果语言能找到,但是国家没找到或国家是其他国家,则语言将和最适当的国家一起使用。
如果语言和国家都没有找到,则QLocale 为默认的语言环境。
可以用 language() 和 country() 来确定实际使用的语言和国家。
另外一种构造QLocale 对象的方法是指定语言环境名称。
QLocale korean("ko");
QLocale swiss("de_CH");
构造函数将语言环境名称转为语言/国家。它不只用系统语言环境数据库。
注意:对于当前键盘输入区域,检查一下QInputMethod::locale().。
http://blog.csdn.net/hai200501019/article/details/9202807