XML介绍
XML 用于存储数据,数据的形式类似于树结构(参考: http://www.runoob.com/xml/)
示例如下
<?xml version="1.0" encoding="ISO-8859-1"?> <note> <to>George</to> <from>John</from> <heading>Reminder</heading> <body>Don't forget the meeting!</body> </note>
其中第一行是XML声明,定义XML版本(1.0)以及所使用的编码格式
接下来的<note>,便是该文档的根元素
剩下的<to>,<from>,<heading>,<body>便是<note>的子元素
QXmlStreamReader
常用函数:
QStringRef documentEncoding(); //获取XML编码,如果XML声明中未指定,则返回NULL
QStringRef documentVersion () ; //获取XML版本,如果XML声明中未指定,则返回NULL
bool atEnd (); //如果读者一直读到XML文档的末尾，或者出现了错误，并且阅读被中止，那么返回true。否则,它将返回false。 //读取XML内容,如果读到XML末尾,或者读取出错时,将返回true,否则返回false //当返回true时,可以通过error()判断是否读取出错
Error error () ; //返回错误类型,如果未出错,将返回QXmlStreamReader::NoError(数值0)
void raiseError ( constQString & message = QString() ); //主动上报错误,并填入message 错误信息(可以通过errorString()获取),可以使得下次调用atEnd()时,直接返回true值
QString errorString(); //获取发生的错误信息
void QXmlStreamReader::setDevice ( QIODevice *device ); //设置QXmlStreamReader的解析设备,等价于QXmlStreamReader ( QIODevice *)构造函数
TokenType readNext(); //读取一次记号,并返回该数据的标志位,也可以通过 //常用标记如下所示: QXmlStreamReader::StartDocument //文档开始位置,用来定义XML版本,编码等信息, QXmlStreamReader::StartElement //元素开始位置 QXmlStreamReader::EndElement //元素结束位置
//比如<firstname>Anna</firstname> //<firstname> </firstname>元素便是元素开始以及结束位置. //“Anna”信息可以通过readElementText()成员函数获取.
QXmlStreamAttributes attributes(); //获取元素的属性 //比如<entry term="of pictures"> //通过attributes().value("term").toString()则可以得到元素值"of pictures"
XML解析示例
以解析G:/QT/in.xml为例,该文件内容如下所示:
<?xml version="1.0"?> <bookindex> <entry term="sidebearings"> <page>10</page> <page>34-35</page> <page>307-308</page> </entry> <entry term="subtraction"> <entry term="of pictures"> <page>115</page> <page>244</page> </entry> <entry term="of vectors"> <page>9</page> </entry> </entry> </bookindex>
代码如下所示:
#include <QtGui>
void ParseEntry(QXmlStreamReader* reader,QTreeWidgetItem* widget) //递归函数，用来解析entry元素 { QTreeWidgetItem *item =new QTreeWidgetItem(widget); //在widget下创建节点 item->setText(0,reader->attributes().value("term").toString()); //获取entry元素的"term"值,并添加到第1列,比如"sidebearings" QString pages; while(!reader->atEnd()) { QXmlStreamReader::TokenType type=reader->readNext(); if(type==QXmlStreamReader::EndElement && reader->name()=="entry") //如果遇到 </entry>,则表示解析完成 { break; } if(type==QXmlStreamReader::StartElement) { if(reader->name()=="entry") ParseEntry(reader,item); //如果是entry子元素,则继续递归执行
else if(reader->name()=="page") pages=pages+reader->readElementText()+" "; //如果是page,则获取文本信息
else reader->raiseError("Element Name Error "); //是其它元素,则上报Error信息 } } item->setText(1,pages); //添加页数到第二列 } void readFile(QFile* File) { QXmlStreamReader* reader = new QXmlStreamReader(File); QTreeWidget* widget = new QTreeWidget(); QStringList header; header<<"term"<<"page"; widget->setHeaderLabels(header); while(!reader->atEnd()) { QXmlStreamReader::TokenType type=reader->readNext(); if(type==QXmlStreamReader::StartElement && reader->name()=="entry") ParseEntry(reader,widget->invisibleRootItem()); //开始解析"entry"元素里的内容 } File->close(); widget->show(); if(reader->hasError()) //如果解析出错 { QMessageBox::information(NULL,"Read","Read :"+reader->errorString()); } } int main(int argc, char *argv[]) { QApplication a(argc,argv); QFile* File = new QFile("G:/QT/in.xml"); if(!File->open(QFile::ReadOnly | QFile::Text)) { QMessageBox::information(NULL,"Open","Open error!"); return 0; } readFile(File); //解析File
a.exec(); }
效果:
QXmlStreamWriter
常用函数
void setAutoFormatting(bool enable) //设置自动格式化文本，XML文本输出时，转化成容易读的形式，否则，就是一整行
void setAutoFormattingIndent(int spacesOrTabs)//格式化时缩进值，默认4个空格位
void setCodec(const char * codecName );
//设置编码格式,必须放在writeStartDocument()函数前面才起作用
void writeStartDocument(); void writeEndDocument(); void writeStartElement(constQString & qualifiedName ); void writeEndElement() void writeAttribute( constQString & qualifiedName, const QString & value ); //写入元素的属性值
void writeTextElement( constQString & qualifiedName, const QString & text ); //写入文本元素,比如<page>10</page>等于writeTextElement("page","10");
示例
#include <QtGui> #include "widget.h"
void WriteEntry(QXmlStreamWriter *writer,QString value,QStringList pages) { writer->writeStartElement("entry"); writer->writeAttribute("term",value); foreach(QString page,pages) writer->writeTextElement("page",page); writer->writeEndElement(); } int main(int argc, char *argv[]) { QApplication a(argc, argv); QFile file("./out.xml"); if(!file.open(QIODevice::WriteOnly | QIODevice::Text)) { QMessageBox::information(NULL,"Error","Write Error"); return 0; } QXmlStreamWriter writer(&file); writer.setAutoFormatting(true); writer.writeStartDocument(); WriteEntry(&writer,"sidebearings",QStringList()<<"10"<<"34-35"<<"307-308"); writer.writeStartElement("entry"); writer.writeAttribute("term","subtraction"); WriteEntry(&writer,"of pictures",QStringList()<<"115"<<"34-35"<<"244"); WriteEntry(&writer,"of vectors",QStringList()<<"9"); writer.writeEndElement(); writer.writeEndDocument(); file.close(); return 0; }
实现
<?xml version="1.0" encoding="UTF-8"?>
<entry term="sidebearings">
<page>10</page>
<page>34-35</page>
<page>307-308</page>
</entry>
<entry term="subtraction">
<entry term="of pictures">
<page>115</page>
<page>34-35</page>
<page>244</page>
</entry>
<entry term="of vectors">
<page>9</page>
</entry>
</entry>