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