Класс 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, чтение должно разрешить сущность самостоятельно, если оно не равно 0, оно должно указывать на источник ввода, который используется чтением.

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