【Qt】 XML流读写XML

川长思鸟来 2022-11-13 12:25 207阅读 0赞

## 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的使用也十分简单，只需要调用相应记号的写入函数来写入相关数据即可。

执行结果 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][https_dengjin.blog.csdn.net_article_details_115174639]

**6.2 源码下载**  
网址：[【Qt】 XML流读写XML.rar][Qt_ XML_XML.rar]

[https_dengjin.blog.csdn.net_article_details_115174639]: https://dengjin.blog.csdn.net/article/details/115174639
[Qt_ XML_XML.rar]: https://download.csdn.net/download/dengjin20104042056/16142340