Класс QXmlErrorHandler

Класс QXmlErrorHandler предоставляет интерфейс для отчётности об ошибках в данных XML. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Открытые функции

Подробное описание

Класс QXmlErrorHandler предоставляет интерфейс для отчётности об ошибках в данных XML.

Если вы хотите, чтобы ваше приложение сообщало об ошибках пользователю или выполняло настраиваемую обработку ошибок, вы должны создать подкласс этого класса.

Вы можете установить обработчик ошибок с помощью 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() для получения сообщения об ошибке.