Класс QXmlEntityResolver

Класс QXmlEntityResolver предоставляет интерфейс для разрешения внешних сущностей, содержащихся в XML-данных. Подробнее...

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

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

Публичные функции

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

Класс QXmlEntityResolver предоставляет интерфейс для разрешения внешних сущностей, содержащихся в XML-данных.

Если приложению необходимо реализовать настраиваемую обработку внешних сущностей, оно должно реализовать этот интерфейс, т.е. resolveEntity(), и зарегистрировать его с помощью QXmlReader::setEntityResolver().

См. также QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlErrorHandler, QXmlLexicalHandler и Введение в SAX2.

Документация по функциям-членам

[virtual] QXmlEntityResolver::~QXmlEntityResolver()

Уничтожает обработчик сущностей.

[pure virtual] QString QXmlEntityResolver::errorString() const

Читатель вызывает эту функцию, чтобы получить строку ошибки, если любая из функций обработчика возвращает false.

[pure virtual] bool QXmlEntityResolver::resolveEntity(const QString &publicId, const QString &systemId, QXmlInputSource *&ret)

Читатель вызывает эту функцию перед открытием любой внешней сущности, за исключением основной сущности документа. Приложение может запросить разрешение сущности самим читателем (ret равно 0) или использовать совершенно другой источник ввода (ret указывает на источник ввода).

Читатель удаляет источник ввода ret, когда больше не нуждается в нём, поэтому вы должны выделить его в куче с помощью new.

Аргумент publicId — это общественный идентификатор внешней сущности, systemId — системный идентификатор внешней сущности, а ret — возвращаемое значение этой функции. Если ret равно 0, читатель должен разрешить сущность сам, если оно отлично от нуля, оно должно указывать на источник ввода, который читатель использует вместо него.

Если эта функция возвращает false, читатель останавливает парсинг и сообщает об ошибке. Читатель использует функцию errorString() для получения сообщения об ошибке.