Qt中使用QXmlStreamReader处理XML文件

最新推荐文章于 2025-10-09 23:00:48 发布

原创最新推荐文章于 2025-10-09 23:00:48 发布 · 2.8k 阅读

14 ·

CC 4.0 BY-SA版权

文章标签：

#xml #qt #开发语言 #c++

Qt 专栏收录该内容

20 篇文章

订阅专栏

本文介绍了如何使用Qt库中的QXmlStreamReader类进行XML文档的一次性遍历解析，通过示例代码展示了如何处理XML文档的各个节点，包括元素、属性、字符等内容，并给出了一个简单的XML文件解析示例，最后展示了代码运行的可视化结果。

QXmlStreamReader：一种快速的基于流的方式访问XML格式文档，比较适合实现一次解析。即我们只需要读取文档一次，然后像一个遍历器从头到尾一次性处理XML文档，读取期间不会出现读完第一个标签，然后读第二个标签，读完第二个又返回去读第一个的情况。与读对应的是写（QXmlStreamWriter）。

一个比较经典的QXmlStreamReader的循环如下：

QXmlStreamReader xml;
    ...
    while (!xml.atEnd()) {
          xml.readNext();
          ... // do processing
    }
    if (xml.hasError()) {
          ... // do error handling
    }

先介绍一下解析中的几个类型：

类型	描述
QXmlStreamReader::NoToken	读取器还没有读取到任何东西。
QXmlStreamReader::Invalid	有一个错误发生，调用error()或errorString()函数查看。
QXmlStreamReader::StartDocument	文档开始节点。此时调用documentVersion()可以获取XML的版本号，调用documentEncoding()可以获取XML中指定的编码等。
QXmlStreamReader::EndDocument	文档结束节点。
QXmlStreamReader::StartElement	元素开始节点。调用name()获取名称，调用attributtes()获取摘要等。
QXmlStreamReader::EndElement	元素结束节点。
QXmlStreamReader::Characters	字符节点。调用text()函数可以获取字符串。
QXmlStreamReader::Comment
QXmlStreamReader::DTD
QXmlStreamReader::EntityReference
QXmlStreamReader::ProcessingInstruction

示例如下XML文档：

<message>
    <header class="class1">
        <name type = "char">first grade</name>
        <teacher type = "char">Tom</teacher>
    </header>
    <students size = "3">
        <name age= "11">xiaomin</name>
        <name age= "12">xiaohong</name>
        <name age= "13">xiaogang</name>
    </students>
</message>

解析上面XML文档如下：

StartDocument
StartElement (name() == "message")
StartElement (name() == "header" attribute() ==(class,class1))
StartElement (name() == "name" attribute() ==(type,char))
Characters (text() == "first grade")
EndElement (name() == "name")
StartElement (name() == "teacher" attribute() ==(type,char))
Characters (text() == "Tom")
EndElement (name() == "teacher")
EndElement (name() == "header")
StartElement (name() == "students" attribute() ==(size,3))
StartElement (name() == "name" attribute() ==(age,11))
Characters (text() == "xiaomin")
EndElement (name() == "name")
StartElement (name() == "name" attribute() ==(age,12))
Characters (text() == "xiaohong")
EndElement (name() == "name")
StartElement (name() == "name" attribute() ==(age,13))
Characters (text() == "xiaogang")
EndElement (name() == "name")
EndElement (name() == "student")
EndElement (name() == "message")
EndDocument

示例代码：

void MainWindow::readStartElement(QTreeWidgetItem *parent){
    while (!reader.atEnd()) {
        if(reader.isEndElement() && reader.name() == parent->text(0)){
            break;
        }
        if(reader.isStartElement() && reader.name() != ""){
            QTreeWidgetItem *item = new QTreeWidgetItem(parent);
            //显示tagName名称
            item->setText(0,reader.name().toString());
            //显示摘要
            if(reader.attributes().size()>0) item->setText(2,reader.attributes().first().name() + ":" + reader.attributes().first().value());
            reader.readNext();
            //显示字符的值
            item->setText(1,reader.text().toString());
            readStartElement(item);
        }
        reader.readNext();
    }
}

void MainWindow::readXMLFile(QString path, QTreeWidgetItem *parent){
    QFile file(path);
    if(!file.open(QFile::ReadOnly | QFile::Text)){
        return;
    }
    reader.setDevice(&file);
    reader.readNext();
    while(!reader.atEnd()){
        if(reader.isStartElement()){
            readStartElement(parent);
            reader.readNext();
        }else{
            reader.readNext();
        }
    }
    file.close();
}

运行代码图示：