Qt模块化笔记之core——QXmlStreamReader的使用

最新推荐文章于 2025-07-10 16:46:25 发布
最新推荐文章于 2025-07-10 16:46:25 发布
阅读量6.7k 收藏 2
点赞数 1
CC 4.0 BY-SA版权
分类专栏： Qt模块化笔记之core
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/iloveqt5/article/details/18980313
本文介绍Qt中的QXmlStreamReader类的基本用法，包括构造函数、成员函数等，并通过一个实例展示了如何解析XML文件。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

QXmlStreamReader

公有函数如下：

	QXmlStreamReader()
	QXmlStreamReader(QIODevice * device)
	QXmlStreamReader(const QByteArray & data)
	QXmlStreamReader(const QString & data)
	QXmlStreamReader(const char * data)
	~QXmlStreamReader()

void	setDevice(QIODevice * device)//以下四个都用于添加xml数据
void	addData(const QByteArray & data)
void	addData(const QString & data)
void	addData(const char * data)

void	addExtraNamespaceDeclaration(const QXmlStreamNamespaceDeclaration & extraNamespaceDeclaration)//添加额外命名空间申明
void	addExtraNamespaceDeclarations(const QXmlStreamNamespaceDeclarations & extraNamespaceDeclarations)
void	setEntityResolver(QXmlStreamEntityResolver * resolver)//添加实体解析器
void	setNamespaceProcessing(bool)

bool	atEnd() const//以下几个用于循环中，遍历元素(标签)
TokenType	readNext()
QString	readElementText(ReadElementTextBehaviour behaviour = ErrorOnUnexpectedElement)
bool	readNextStartElement()
void	skipCurrentElement()//跳过当前元素
void	clear()

bool	isDTD() const//以下判断当前遍历到的元素属于哪种类型
bool	isCDATA() const
bool	isCharacters() const
bool	isComment() const
bool	isStartDocument()const
bool	isStartElement() const
bool	isEndDocument() const
bool	isEndElement() const
bool	isEntityReference() const
bool	isProcessingInstruction() const
bool	isStandaloneDocument() const
bool	isWhitespace() const

QStringRef	documentEncoding() const
QStringRef	documentVersion() const
QStringRef	dtdName() const
QStringRef	dtdPublicId() const
QStringRef	dtdSystemId() const
qint64	lineNumber() const
QStringRef	name() const//仅返回StartElement, EndElement或EntityReference的标签名
QStringRef	prefix() const//返回的应是涉及命名空间的前辍
QStringRef	text() const//仅返回Characters, Comment, DTD, 或 EntityReference.中的文本部分
QString	tokenString() const
TokenType	tokenType() const
QIODevice *	device() const
qint64	characterOffset() const
qint64	columnNumber() const//返回当前解析到的行数

bool	hasError() const//出错处理
Error	error() const
QString	errorString() const
void	raiseError(const QString & message = QString())

QXmlStreamAttributes	attributes() const
QXmlStreamEntityDeclarations	entityDeclarations() const
QXmlStreamEntityResolver *	entityResolver() const
QXmlStreamNamespaceDeclarations	namespaceDeclarations() const
QStringRef	processingInstructionData() const
QStringRef	processingInstructionTarget() const
QStringRef	qualifiedName() const
bool	namespaceProcessing() const
QStringRef	namespaceUri() const
QXmlStreamNotationDeclarations	notationDeclarations() const
将上节的某篇抄过来，并添加一些部分，说明各部分与Qt对应的函数名： 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
<!--这是一个便签-->  
<!DOCTYPE Notes [  
    <!ELEMENT note (date,message)>  
    <!ELEMENT date (#PCDATA)>  
    <!ELEMENT message (#PCDATA)>  
]>  
<Notes>  
    <note>  
        <date>2月1日</date>  
        <message>别忘了参加party</message>  
    </note>  
    <note> 
	<?this is the most important ?> 
        <date>2月14日</date>  
        <message>今天情人节啊</message>  
    </note>  
    <note>  
        <date>2月18日</date>  
        <message>今天自己煮饭吧</message>  
    </note>  
</Notes>

左边的为qt中的函数名，右端为对应XML部分

头部声明部分

StartDocument()——<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

documentVersion()——version="1.0"

documentEncoding()——encoding="UTF-8"

StandaloneDocument()——standalone="yes"

DTD部分

notationDeclarations()——<!ELEMENT note (date,message)>

entityDeclarations()——<!ELEMENT date (#PCDATA)><!ELEMENT message (#PCDATA)>

dtdName——Notes，<!DOCTYPE 后的那个，也即根元素名

dtdPublicId()和dtdSystemId()——注来自点此查看区别

实体部分：

CDATA()——CDATA 部分中的所有内容都会被解析器忽略而直接有效，与注释不同，格式为：<![CDATA[" 内容 "]]>。见点击打开链接

EntityReference——实体引用


ProcessingInstruction()——处理指令，看下面的引用说明

引自:

http://zhidao.baidu.com/question/67891842.html?si=1

下面的一行就是在第二本书的定义之前的：
<?page render multiple authors ?>
虽然它看上去很像XML序言，但实际上是一种称为处理指令（processing instruction）的不同类型的语法。处理指令（以下简称PI）的目的是为了给处理页面的程序（例如XML解析器）提供额外的信息。PI通常情况下是没有固定格式的，唯一的要求是紧随第一个问号必须至少有一个字母。在此之后，PI可以包含除了小于号和大于号之外的任何字符串序列。最常见的PI是用来指定XML文件的样式表：这个PI一般会直接放在XML序言之后，通常由Web浏览器使用，来将XML数据以特殊的样式显示出来。


 这个类自身有个TokenType（标签类型）用来描述当前解析到的文档部分，与上面我归纳的是近似的

enum QXmlStreamReader::TokenType

Constant Value Description
QXmlStreamReader::NoToken 0 The reader has not yet read anything.
QXmlStreamReader::Invalid 1 An error has occurred, reported in error() and errorString().
QXmlStreamReader::StartDocument 2 The reader reports the XML version number indocumentVersion(), and the encoding as specified in the XML document in documentEncoding(). If the document is declared standalone, isStandaloneDocument() returns true; otherwise it returns false.
QXmlStreamReader::EndDocument 3 The reader reports the end of the document.
QXmlStreamReader::StartElement 4 The reader reports the start of an element with namespaceUri() and name(). Empty elements are also reported as StartElement, followed directly by EndElement. The convenience functionreadElementText() can be called to concatenate all content until the corresponding EndElement. Attributes are reported inattributes(), namespace declarations innamespaceDeclarations().
QXmlStreamReader::EndElement 5 The reader reports the end of an element with namespaceUri() and name().
QXmlStreamReader::Characters 6 The reader reports characters in text(). If the characters are all white-space, isWhitespace() returns true. If the characters stem from a CDATA section, isCDATA() returns true.
QXmlStreamReader::Comment 7 The reader reports a comment in text().
QXmlStreamReader::DTD 8 The reader reports a DTD in text(), notation declarations innotationDeclarations(), and entity declarations inentityDeclarations(). Details of the DTD declaration are reported in in dtdName(), dtdPublicId(), and dtdSystemId().
QXmlStreamReader::EntityReference 9 The reader reports an entity reference that could not be resolved. The name of the reference is reported in name(), the replacement text in text().
QXmlStreamReader::ProcessingInstruction 10 The reader reports a processing instruction inprocessingInstructionTarget() and processingInstructionData().
————————————————————————————————————————————————————————————————————

基础使用示例：


将上面XML代码保存为text.xml。

代码：

#include "dialog.h"
#include "ui_dialog.h"
#include <QFile>
#include <QIODevice>
#include <QDebug>
Dialog::Dialog(QWidget *parent) :
    QDialog(parent),
    ui(new Ui::Dialog)
{
    ui->setupUi(this);
    QFile *file=new QFile("://test.xml");
    if(!file->open(QIODevice::ReadOnly))
    {
        qDebug()<<"文件打开失败";
        return;
    }
    xmlReader =new QXmlStreamReader(file);
    while(!xmlReader->atEnd() && !xmlReader->hasError())
    {
        xmlReader->readNext();
        if(xmlReader->isStartElement())
        {

            if(xmlReader->name()=="note")
            {
                qDebug()<<"————note————";
            }else if (xmlReader->name()=="date") {
                qDebug()<<"date:"<<xmlReader->readElementText();
            }else if (xmlReader->name()=="message") {
                qDebug()<<"message:"<<xmlReader->readElementText();
            }
        }

    }
}

Dialog::~Dialog()
{
    delete ui;
}


输出为：

————note————

date: "2月1日"

message: "别忘了参加party"

————note————

date: "2月14日"

message: "今天情人节啊"

————note————

date: "2月18日"

message: "今天自己煮饭吧" 

————————————————————————————————————————————————————————————————————

对于出错，错语类型枚举值有

enum QXmlStreamReader::Error

Constant Value Description
QXmlStreamReader::NoError 0 无错误
QXmlStreamReader::CustomError 2 自定义错误，通过raiseError()定义错误信息，不懂怎样使用，求赐教
QXmlStreamReader::NotWellFormedError 3 xml格式有问题，比如标签不配对，嵌套不正确。The parser internally raised an error due to the read XML not being well-formed.
QXmlStreamReader::PrematureEndOfDocumentError 4 来源的数据不完整，如通过网络传输来的The input stream ended before a well-formed XML document was parsed. Recovery from this error is possible if more XML arrives in the stream, either by calling addData() or by waiting for it to arrive on thedevice().
QXmlStreamReader::UnexpectedElementError 1 意料之外的元素？求教The parser encountered an element that was different to those it expected.


Qt 之解析 XML（QXmlStreamReader）
青春不老，奋斗不止！
10-14 2万+
QXmlStreamReader 类提供了一个快速解析器，用于通过简单的流 API 读取格式良好的 XML。与之相对应的是 QXmlStreamWriter（写入 XML）。
Qt开发（六）使用QXmlStreamReader 读取 XML
Postgres 数据库内核开发工程师
07-03 9275
1. QXmlStreamReader概述 1. 在 [ 使用 DOM 读取 XML] 中介绍了如何使用 DOM 文档对象模型的方式来读写 XML的方法。在 Qt 中使用DOM方式来去写 XML文件是非常方便的，但是存在一个缺点，那就是当 XML 文件比较大的时候，使用 DOM 将该 XML 文件内容加载到内存中的时候，会比较占内存空间。因此往往我们使用更多的是 QXmlStreamReader...
使用QXmlStreamReader和QXmlStreamWriter读写XMl文件
04-20 4174
使用QXmlStreamReader和QXmlStreamWriter读写XMl文件
Qt之解析XML（QXmlStreamReader）
weixin_34029949的博客
10-14 2071
简述 QXmlStreamReader 类提供了一个快速解析器，用于通过简单的流 API 读取格式良好的 XML。与之相对应的是 QXmlStreamWriter（写入 XML）。 相比较 Qt 自己的 SAX 解析器（见 QXmlSimpleReader），QXmlStreamReader 更快，更方便。某些情况下，在使用 DOM...
Qt配置文件管理：深入QXmlStreamReader与QXmlStreamWriter
最新发布
weixin_30248619的博客
07-10 303
在软件开发过程中，配置文件的读写操作是必不可少的一部分。Qt框架作为一款跨平台的C++图形用户界面应用程序开发框架，为开发者提供了多种配置文件处理方式。本章将概述Qt框架中处理配置文件的方法，涵盖从简单的配置项存储到复杂的XML和JSON文件的读写操作。Qt为不同级别的配置需求提供了灵活的选择，无论是快速读写小规模的配置项，还是处理复杂的结构化数据，Qt都能提供简洁高效的解决方案。本章将为读者揭示Qt配置文件读写的基本概念和适用场景，为后续章节的深入探讨奠定基础。
QXmlStreamReader
u013523953的专栏
06-21 248
enum QXmlStreamReader::TokenType This enum specifies the type of token the reader just read. Constant Value Description Example QXmlStreamReader::NoToken 0 The reader has not yet read anyt...
QtXml：QXmlStreamReader
hw5230的博客
08-17 361
QXmlStreamReader 提供了一个简单的流 API 来解析格式良好的 XML。QXmlStreamReader 在设计上是内存保守的，因为它不会将整个 XML 文档树存储在内存中，而是仅存储当前标记。此外，它通过将所有字符串数据报告为 QStringRef 而不是真正的 QString 对象来实现这一点。
QXmlStreamReader_QT_Demo:使用QT里的QXmlStreamReader读取Xml文件的一个Demo
07-09
使用QT里的QXmlStreamReader读取Xml文件的一个Demo 由于每个人的build路径不一样，所以这里要先把text.xml放到D盘根目录！统一使用了绝对路径：“D:\text.xml” 如果是Linux平台可以根据自己路径进行在main函数里...
QT C++ 下测试QXmlStreamReader与PugiXml效率对比源码(无需积分)
11-07
使用Qt5.6.1环境，只对比了QXmlStreamReader与PugiXml的效率， 测试前，将源码路径下的large.xml拷贝到执行程序路径下 需要自行编译 代码使用截止日期：‎2020-‎11-0‎7 ‏‎15:54:35 github的代码 硬件条件：CPU=...
qt 常用配置文件读写QXmlStreamReader/QXmlStreamWrite
09-08
本篇文章将深入探讨如何使用Qt中的`QSettings`、`QXmlStreamReader`、`QXmlStreamWriter`以及`QDomDocument`进行XML配置文件的读写，同时也会提及JSON文件的处理方式。 首先，我们来看`QSettings`类。它是Qt提供的...
QT QXmlStreamReader
Allen Roson
07-08 1514
概述 QXmlStreamReader类提供了一个快速解析器，用于通过一个简单的流API读取格式良好的XML。 QXmlStreamReader是Qt自己的SAX解析器的更快、更方便的替代品(参见QXmlSimpleReader)。在某些情况下，对于使用DOM树的应用程序(请参阅QDomDocument)，它可能是一种更快、更方便的替代方法。QXmlStreamReader从QIODevice(参见setDevice())读取数据，或从原始QByteArray(参见addData...
Qt之解析XML元素（QXmlStreamReader）
波风水门
04-01 977
简述详细介绍使用 简述 对于 XML 的内容，通常情况下，我们只关心 XML 元素的解析。这时，可以通过 QXmlStreamReader 中的便利函数 readNextStartElement() 来实现。 详细介绍 之前使用的方式主要使用 readNext() 来读取下一个标记，并返回对应的类型。 QXmlStreamReader xml; ... while (!xml.atEnd()) ...
Qt xml解析之QXmlStreamReader
不经一翻彻骨寒，怎得梅花扑鼻香
08-28 3410
自QT4.3版本开始，QT提供了两个新类来读写XML：QXmlStreamReader 和 QXmlStreamWriter。顾名思义，QXmlStreamReader用于读取XML，QXmlStreamWriter用于写入XML。这两个类都使用流的方式操作xml，比起使用DOM和SAX解析xml，这是最快最方便的操作xml的方法。
Qt xml 读写之QXmlStreamReader
U201414786的博客
01-07 2137
qt 处理 xml主要有两个方式  QXmlStreamReader 和QDomDocument 本文简绍 QXmlStreamReader 的读与写；并给出测试过的代码和xml； 一个xml文件的一般格式:&lt;quote&gt; Aquotion&lt;/quote&gt;。元素中可以插入属性，但是属性值一定要用双引号。 读取xml文件 第一步 打开文件 QString dpat...
QXmlStreamReader 解析xml
redpetallsg的专栏
12-10 2605
作为记录，代码如下： QXmlStreamReader xml(html);     while (!xml.atEnd())     {         xml.readNext(); //这个是关键函数，挨个读取节点         if (xml.isStartElement())         {             if (xml.name() == "ul")
Qt 解析XML文件 QXmlStreamReader
FightingOning的博客
08-24 899
如何使用QXmlStreamReader来解析格式良好的XML，Qt的文档中指出，它是一种更快、更方便的Qt自己的SAX解析器（QXmlSimpleReader）的替代，它也较快，在某种情况下，比DOM（QDomDocument）更方便。
QXMLStreamReader解析XML文件
qq_40444365的博客
06-06 527
streamparsexml.h#ifndef STREAMPARSEXML_H#define STREAMPARSEXML_H#include &lt;QWidget&gt;#include &lt;QXmlStreamReader&gt;#include &lt;QXmlStreamWriter&gt;#include &lt;QFile&gt;#include &lt;QMessageBox...
QT QXmlStreamReader用法小结
令狐少侠
07-31 8157
一 API介绍     readNext():从xml输入流中读取下一个记号     name():记号的名称，即     isStartElement():判断当前已读取的记号是否为开始元素，开始元素即     isEndElement():判断当前已读取的记号是否为结束元素，结束元素即     readElementText():读取当前记号对应的文本值，     atEnd():
qt使用qxmlstreamreader读取松散HTML文件中的内容
07-04
<think>我们正在使用Qt的QXmlStreamReader来读取松散格式的HTML文件。由于HTML可能不是严格的XML（例如，标签可能没有正确关闭，或者有自闭合标签等），我们需要谨慎处理。解决方案：使用QXmlStreamReader的纠错能力，并注意处理可能的错误。步骤：1.打开HTML文件，并设置为只读模式。2.创建QXmlStreamReader对象，并将文件内容设置给它。3.通过循环读取器的事件，并根据不同的事件类型处理数据。4.对于松散格式的HTML，我们可能会遇到错误，但QXmlStreamReader会尝试恢复。我们可以忽略一些错误，或者根据错误类型进行特殊处理。注意：QXmlStreamReader对HTML的支持有限，特别是对于非良构的HTML。如果遇到严重的格式问题，可能需要使用专门的HTML解析器（如QtWebEngine模块中的解析器），但这里我们只使用QXmlStreamReader。示例代码：我们将读取HTML文件，并提取所有的文本内容（忽略标签）。但是，请注意：如果HTML非常松散，这种方法可能不理想。但对于简单的HTML文件，可以工作。代码示例： ```cpp#include <QCoreApplication>#include <QFile> #include<QXmlStreamReader>#include <QDebug> intmain(intargc,char *argv[]){QCoreApplication a(argc, argv);QFilefile("test.html");if(!file.open(QIODevice::ReadOnly |QIODevice::Text)){qDebug() <<"无法打开文件";return -1;}QXmlStreamReader reader(&file);QString resultText;//用于保存提取的文本while(!reader.atEnd()) {QXmlStreamReader::TokenTypetype= reader.readNext();if (type ==QXmlStreamReader::StartElement){//可以处理特定元素//例如，如果只想提取段落，可以检查元素名是否为"p"//这里我们提取所有元素的文本}else if(type== QXmlStreamReader::Characters){//提取文本resultText+= reader.text();}}if(reader.hasError()) {//处理错误qDebug()<< "XML解析错误："<< reader.errorString();//但可能仍然有一些文本被提取}file.close();qDebug()<< "提取的文本内容：" <<resultText;return0;} ```上述代码会提取HTML文件中的所有文本（标签之间的文本）。但是，如果HTML标签属性中有文本，则不会被提取。对于松散HTML，可能出现的错误包括：标签未正确关闭等。QXmlStreamReader在遇到错误时会停止解析，但上述代码中我们只是记录了错误，并继续使用已经读取到的文本。如果需要更健壮的解析，可以考虑使用其他库，如QTextDocument（通过setHtml方法）或者使用Qt WebEngine模块中的HTML解析器。但QXmlStreamReader是一个轻量级的解决方案。引用说明：上述方法参考了Qt中QXmlStreamReader的基本用法[^1]。 §§相关问题§§1.如何处理HTML文件中的自闭合标签（如`<br/>`）？ 2.如何只提取特定标签（如段落`<p>`）内的文本？ 3.如果HTML文件格式错误严重，除了QXmlStreamReader，Qt还有哪些替代方案可以解析？</think>### 使用 QXmlStreamReader 读取松散 HTML 文件的方法 在 Qt 中使用 `QXmlStreamReader` 解析松散格式的 HTML 文件时，需要注意 HTML 可能不符合严格的 XML 规范（如未闭合标签、属性引号缺失等）。以下是完整解决方案： #### 核心方法 ```cpp #include <QXmlStreamReader> #include <QFile> #include <QDebug> void parseLooseHTML(const QString& filePath) { QFile file(filePath); if (!file.open(QIODevice::ReadOnly | QTextStream::ReadOnly)) { qWarning() << "文件打开失败"; return; } QXmlStreamReader reader(&file); reader.setNamespaceProcessing(false); // 禁用命名空间处理 while (!reader.atEnd()) { switch (reader.readNext()) { case QXmlStreamReader::StartElement: qDebug() << "开始标签:" << reader.name(); // 读取属性 for (const auto& attr : reader.attributes()) { qDebug() << " |- 属性:" << attr.name() << "=" << attr.value(); } break; case QXmlStreamReader::Characters: if (!reader.isWhitespace()) { qDebug() << "文本内容:" << reader.text().trimmed(); } break; case QXmlStreamReader::EndElement: qDebug() << "结束标签:" << reader.name(); break; case QXmlStreamReader::Invalid: // 处理松散格式错误 if (reader.error() == QXmlStreamReader::NotWellFormedError) { qWarning() << "格式错误，尝试恢复:" << reader.errorString(); reader.clearError(); // 清除错误继续解析 } break; } } if (reader.hasError()) { qCritical() << "解析终止错误:" << reader.errorString(); } file.close(); } ``` #### 关键处理技巧 1. **错误恢复机制** 当遇到 `NotWellFormedError` 错误时（常见于松散 HTML），调用 `clearError()` 清除错误状态并继续解析： ```cpp case QXmlStreamReader::Invalid: if (reader.error() == QXmlStreamReader::NotWellFormedError) { reader.clearError(); // 关键恢复步骤 } ``` 2. **预处理 HTML（推荐）** 使用 Qt 内置工具先清理 HTML： ```cpp #include <QTextDocument> QString sanitizeHTML(const QString& rawHtml) { QTextDocument doc; doc.setHtml(rawHtml); // 自动修正格式 return doc.toHtml(); // 返回规范化的HTML } ``` 3. **标签处理注意事项** - 对于自闭合标签（如 `<br>`），HTML 中可能写作 `<br>` 而非 `<br/>` - 属性值引号可能缺失（如 `<div id=main>`） - 使用 `reader.name().toString()` 获取标签名时忽略大小写差异 #### 使用示例 ```cpp // 在main函数中调用 int main() { parseLooseHTML("index.html"); return 0; } ``` #### 输出示例 ``` 开始标签: "html" 开始标签: "body" 开始标签: "div" |- 属性: "class" = "content" 文本内容: "Hello World" 结束标签: "div" 结束标签: "body" 结束标签: "html" ``` #### 备选方案 对于极端松散的 HTML，建议： 1. 使用 `QTextDocument::setHtml()` 自动修正格式 2. 采用第三方库如 [Gumbo Parser](https://github.com/google/gumbo-parser) 3. 使用 Qt WebEngine 的 `QWebEnginePage::toHtml()`[^1] [^1]: 实现绘制方法：重写paint(QPainter *painter, const QStyleOptionGraphicsItem *option, QWidget *widget)方法，以自定义项的绘制方式。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值