QXmlErrorHandler 类
QXmlErrorHandler 类提供了报告 XML 数据错误的接口。更多信息...
头文件 | #include <QXmlErrorHandler> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Core5Compat) target_link_libraries(mytarget PRIVATE Qt6::Core5Compat) |
qmake | QT += core5compat |
继承自 |
注意: 本类中所有函数都是 重入的。
公共函数
virtual | ~QXmlErrorHandler() |
virtual bool | error(const QXmlParseException &exception) = 0 |
virtual QString | errorString() const = 0 |
virtual bool | fatalError(const QXmlParseException &exception) = 0 |
virtual bool | warning(const QXmlParseException &exception) = 0 |
详细描述
如果您想使您的应用程序向用户报告错误或执行自定义错误处理,则应该从该类派生。
您可以使用 QXmlReader::setErrorHandler() 设置错误处理程序。
可以使用 warning()、error() 和 fatalError() 报告错误,错误文本使用 errorString() 报告。
另请参阅:QXmlDTDHandler、QXmlDeclHandler、QXmlContentHandler、QXmlEntityResolver 和 QXmlLexicalHandler。
成员函数说明
[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. 的商标。所有其他商标均为各自所有者的财产。