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

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