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