【Qt】 XML流读写XML

00. 目录

文章目录

00. 目录
01. 概述
02. 开发环境
03. 读取XML文档
04. 写入XML文档
05. 预留
06. 附录

01. 概述

从Qt 4.3开始引入了两个新的类来读取和写入XML文档： QXmlStreamReader和QXmlStreamWriter。

QXmlStreamReader类提供了一个快速的解析器，通过一个简单的流API来读取格式良好的XML文档，它是作为Qt的SAX解析器的替代品的身份出现的，因为它比SAX解析器更快更方便。流读取器的基本原理就是将XML文档报告为一个记号（tokens）流，应用程序代码自身来驱动循环，在需要的时候可以从读取器中一个接一个的拉出记号。这个是通过调用readNext()函数实现的，它可以读取下一个记号，然后返回一个记号类型，它由QXmlStreamReader::TokenType定义，其所有取值如表所列。然后可以使用isStartElement()和text()等函数来判断这个记号是否包含需要的信息。

与QXmlStreamReader对应的是QXmlStreamWriter，它通过一个简单的流API提供了一个XML写入器。QXmlStreamWriter的使用也是十分简单的，只需要调用相应的记号的写入函数来写入相关数据即可。

XML流包含两个部分QXmlStreamReader和和QXmlStreamWriter。 QXmlStream Reader 类提供了一个快速的解析器．它通过一个简单的流API 来读取格式良好的XML 文挡，它是作为Qt 的SAX 解析器的替代品身份出现的，因为它比SAX 解析器更快更方便。

在SAX 中，应用程序必须提供处理器（回调函数）来从解析器获得所谓的XML 事件；而QXmlStreamReader是应用程序代码向身来驱动循环，在需要的时候可以从读取器中一个接一个地拉出记号。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-tauu8Hp2-1616769486826)(assets/image-20210326220914076.png)]

温馨提示

在Qt6中，SAX解析方式已经不推荐使用，强烈建议使用QXmlStreamReader和QXmlStreamWriter代替。

02. 开发环境

Windows系统：Windows10

Qt版本：Qt5.15或者Qt6

03. 读取XML文档

3.1 新建Qt控制台应用QtConsole Application，项目名称为18XML，完成后将18XML.pro文件的第一行代码更改为：

QT += xml

3.2 在main.cpp文件，将内容更改如下：

#include <QCoreApplication>#include <QFile>
#include <QXmlStreamReader>
#include <QXmlStreamWriter>
#include <QDebug>int main(int argc, char *argv[])
{QCoreApplication a(argc, argv);QFile file("../18XML/test.xml");if (!file.open(QFile::ReadOnly | QFile::Text)){qDebug() << "Error: 打开文件失败";return 1;}QXmlStreamReader reader;//设置文件 将流设置为初始状态reader.setDevice(&file);//如果没有读到文档结尾 而且没有出现错误while(!reader.atEnd()){//读取下一个记号 它返回记号的类型QXmlStreamReader::TokenType type = reader.readNext();//下面根据记号的类型来进行不同的输出if (type == QXmlStreamReader::StartDocument){qDebug() << reader.documentEncoding() << reader.documentVersion();}if (type == QXmlStreamReader::StartElement){qDebug() << "<" << reader.name() << ">";if (reader.attributes().hasAttribute("id")){qDebug() << reader.attributes().value("id");}}if (type == QXmlStreamReader::EndElement){qDebug() << "</" << reader.name() << ">";}if (type == QXmlStreamReader::Characters && !reader.isWhitespace()){qDebug() << reader.text();}}//如果读取中出现了错误 就输出错误信息if (reader.hasError()){qDebug() << "error: " << reader.errorString();}file.close();return a.exec();
}

可以看到流读取器就是在一个循环中通过使用readNext()来不断读取记号的，这里可以对不同的记号和不同的内容进行不同的处理，既可以在本函数中进行，也可以在其他函数或者其他类中进行。运行程序，查看效果。

"UTF-8" "1.0"
< "library" >
< "book" >
"01"
< "title" >
"Qt"
</ "title" >
< "author" >
"LiMing"
</ "author" >
</ "book" >
< "book" >
"02"
< "title" >
"Linux"
</ "title" >
< "author" >
"ZhengGang"
</ "author" >
</ "book" >
</ "library" >

04. 写入XML文档

与QXmlStreamReader对应的是QXmlStreamWriter，它通过一个简单的流API提供了一个XML 写人器。QXmlStreamWriter的使用也十分简单，只需要调用相应记号的写入函数来写入相关数据即可。

#include <QCoreApplication>#include <QFile>
#include <QXmlStreamReader>
#include <QXmlStreamWriter>
#include <QDebug>int main(int argc, char *argv[])
{QCoreApplication a(argc, argv);QFile file("../18XML/test2.xml");if (!file.open(QFile::WriteOnly | QFile::Text)){qDebug() << "Error: 打开文件失败";return 1;}QXmlStreamWriter writer(&file);writer.setAutoFormatting(true);writer.writeStartDocument();writer.writeStartElement("bookmark");writer.writeAttribute("href", "http://www.qt.io");writer.writeTextElement("title", "Qt Home");writer.writeEndElement();writer.writeEndDocument();//关闭文件file.close();qDebug() << "Write Finished";return a.exec();
}

执行结果 test2.xml文件内容如下:

<?xml version="1.0" encoding="UTF-8"?>
<bookmark href="http://www.qt.io">
<title>Qt Home</title>
</bookmark>

这里使用了setAutoFormatting(true)函数来自动设置格式，这样会自动换行和添加缩进。然后使用了writeStartDocument()，该函数会自动添加首行的XML说明（即），添加元素可以使用writeStartElement()，不过，这里要注意，一定要在元素的属性、文本等添加完成后，使用writeTextElement()来关闭前一个打开的元素。在最后使用writeEndDocument()来完成文档的写入。现在大家可以运行程序了，这时会在项目目录中生成一个XML文档。

05. 预留

06. 附录

6.1 Qt教程汇总
网址：https://dengjin.blog.csdn.net/article/details/115174639

6.2 源码下载
网址：【Qt】 XML流读写XML.rar