QXmlErrorHandler 类

QXmlErrorHandler 类提供了报告 XML 数据错误的接口。更多信息...

头文件 #include <QXmlErrorHandler>
CMakefind_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmakeQT += core5compat
继承自

QXmlDefaultHandler

注意: 本类中所有函数都是 重入的

公共函数

virtual~QXmlErrorHandler()
virtual boolerror(const QXmlParseException &exception) = 0
virtual QStringerrorString() const = 0
virtual boolfatalError(const QXmlParseException &exception) = 0
virtual boolwarning(const QXmlParseException &exception) = 0

详细描述

如果您想使您的应用程序向用户报告错误或执行自定义错误处理,则应该从该类派生。

您可以使用 QXmlReader::setErrorHandler() 设置错误处理程序。

可以使用 warning()、error() 和 fatalError() 报告错误,错误文本使用 errorString() 报告。

另请参阅:QXmlDTDHandlerQXmlDeclHandlerQXmlContentHandlerQXmlEntityResolverQXmlLexicalHandler

成员函数说明

[virtual noexcept] QXmlErrorHandler::~QXmlErrorHandler()

销毁错误处理程序。

[pure virtual] bool QXmlErrorHandler::error(const QXmlParseException &exception)

一个阅读器可能使用此函数来报告一个可恢复的错误。可恢复错误对应于 XML 1.0 规范第 1.2 节中“error”的定义。错误的详细情况存放在 exception 中。

调用此函数后,阅读器必须继续提供正常的解析事件。

如果此函数返回 false,阅读器将停止解析并报告错误。阅读器使用函数 errorString() 获取错误消息。

[纯虚函数] QString QXmlErrorHandler::errorString() const

读取器调用此函数以获取错误字符串,如果任何处理器函数返回 false

[纯虚函数] bool QXmlErrorHandler::fatalError(const QXmlParseException &exception)

读取器必须使用此函数来报告不可恢复的错误。错误详情存储在 exception 中。

如果此函数返回 true,则读取器可能会尝试继续解析和报告后续错误,但不会报告任何常规解析事件。

[纯虚函数] bool QXmlErrorHandler::warning(const QXmlParseException &exception)

读取器可能使用此函数来报告警告。警告是按照 XML 1.0 规范定义的非错误或致命错误的条件。警告详情存储在 exception 中。

如果此函数返回 false,阅读器将停止解析并报告错误。阅读器使用函数 errorString() 获取错误消息。

© 2024 The Qt Company Ltd. 包含在内的文档贡献是各自所有者的版权。本处提供的文档是根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款许可的。Qt 和相应的徽标是芬兰及/或全球其他国家的 The Qt Company Ltd. 的商标。所有其他商标均为各自所有者的财产。