Класс QXmlEntityResolver

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