Описание класса QXmlErrorHandler [модуль QtXml]
Класс QXmlErrorHandler обеспечивает интерфейс для сообщений об ошибках в XML данных. Далее...
#include <QXmlErrorHandler> Унаследован от QXmlDefaultHandler.
Замечание: все функции этого класса реентерабильны.
Открытые функции
- 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
Подробное описание
Класс QXmlErrorHandler обеспечивает интерфейс для сообщений об ошибках в XML данных.
Если вы хотите, чтобы ваше приложение сообщало об ошибках пользователю или представляло свою обработку ошибок, вы должны создать класс-потомок от этого класса.
Вы можете установить обработчик ошибок с помощью QXmlReader::setErrorHandler().
Об ошибках можно сообщить с помощью warning(), error() и fatalError(), текст ошибки может быть передан с помощью errorString().
Смотрите также QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlLexicalHandler и Введение в SAX2.
Описание функций-членов
QXmlErrorHandler::~QXmlErrorHandler () [virtual]
Уничтожает обработчик ошибок.
bool QXmlErrorHandler::error ( const QXmlParseException & exception ) [pure virtual]
При чтении анализатор должен использовать эту функцию для сообщения об ошибке извлечения. Востанавливаемая ошибка соответсвующая определению "error" в разделе 1.2 спецификации XML 1.0. Подробности об ошибке сохраняются в exception.
После вызова этой ошибки чтения должно продолжится.
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
QString QXmlErrorHandler::errorString () const [pure virtual]
Эта функция вызывается для получения строки ошибок, если какая-либо функция обработки вернула false.
bool QXmlErrorHandler::fatalError ( const QXmlParseException & exception ) [pure virtual]
При чтении анализатор должен использовать эту функцию для сообщения об ошибках, не связанных с извлечением. Подробности об ошибке сохраняются в exception.
Если эта функция возвращает true, анализатор может продолжить чтение и создание отчётов об ошибках, но сообщения разбора уже не будут создаваться.
bool QXmlErrorHandler::warning ( const QXmlParseException & exception ) [pure virtual]
Анализатор при чтении должен использовать эту функцию для сообщениях о предупреждениях. Предупреждения не содержать информации об ошибках или критических ошибках, определённых в XML 1.0 спецификации. Детали о предупреждении хранятся в exception.
Если эта функция вернула false, чтение останавливается, сообщается об ошибке. Функция errorString() используется для получения сообщения об ошибке.
|