Класс QXmlErrorHandler
Класс QXmlErrorHandler предоставляет интерфейс для отчёта об ошибках в данных XML. Подробнее...
| Заголовок: | #include <QXmlErrorHandler> |
| qmake: | QT += xml |
| Наследуется от: |
Примечание: Все функции в этом классе являются перевходоустойчивыми.
Публичные функции
| 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 и Введение в SAX2.
Документация по членам-функциям
[virtual] QXmlErrorHandler::~QXmlErrorHandler()
Уничтожает обработчик ошибок.
[pure virtual] bool QXmlErrorHandler::error(const QXmlParseException &exception)
Читатель может использовать эту функцию для отчёта о восстанавливаемой ошибке. Восстанавливаемая ошибка соответствует определению "ошибки" в разделе 1.2 спецификации XML 1.0. Подробности об ошибке хранятся в exception.
Читатель должен продолжать предоставлять стандартные события разбора после вызова этой функции.
Если эта функция возвращает false, читатель прекращает разбор и сообщает об ошибке. Читатель использует функцию errorString() для получения сообщения об ошибке.
[pure virtual] QString QXmlErrorHandler::errorString() const
Читатель вызывает эту функцию, чтобы получить строку ошибки, если любая из функций обработчика возвращает false.
[pure virtual] bool QXmlErrorHandler::fatalError(const QXmlParseException &exception)
Читатель должен использовать эту функцию для отчёта о невосстанавливаемой ошибке. Подробности об ошибке хранятся в exception.
Если эта функция возвращает true, читатель может попытаться продолжить разбор и сообщить о дополнительных ошибках, но никакие стандартные события разбора не будут сообщаться.
[pure virtual] bool QXmlErrorHandler::warning(const QXmlParseException &exception)
Читатель может использовать эту функцию для отчёта об ошибке. Предупреждения — это условия, которые не являются ошибками или критическими ошибками, как определено в спецификации XML 1.0. Подробности о предупреждении хранятся в exception.
Если эта функция возвращает false, читатель прекращает разбор и сообщает об ошибке. Читатель использует функцию errorString() для получения сообщения об ошибке.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.13/qxmlerrorhandler.html