Класс QXmlEntityResolver

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

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

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

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

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

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

См. также QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlErrorHandler и QXmlLexicalHandler.

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

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