Класс 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() для получения сообщения об ошибке.