【Qt】 XML流读写XML-卡核

00. 目录

文章目录

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文档。