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