Класс QXmlReader

Класс QXmlReader предоставляет интерфейс для XML-ридеров (т.е. парсеров). Подробнее...

• Список всех членов, включая унаследованные
• Устаревшие члены

Примечание: Все функции в этом классе являются реентерабельными.

Открытые функции

Подробное описание

Этот абстрактный класс предоставляет интерфейс для всех XML-ридеров Qt. В настоящее время в модуле XML Qt имеется только одно реализованное чтение: QXmlSimpleReader. В будущих версиях могут быть доступны и другие читатели с различными свойствами (например, валидирующий парсер).

Архитектура XML-классов следует за интерфейсом SAX2 Java, с названиями, адаптированными для соответствия соглашениям об именовании Qt. Для тех, кто работал с SAX2, работа с классами Qt XML должна быть очень простой.

Все ридеры используют класс QXmlInputSource для чтения входного документа. Поскольку вы, как правило, заинтересованы в конкретном содержании XML-документа, ридер сообщает о содержании через специальные обработчики (QXmlDTDHandler, QXmlDeclHandler, QXmlContentHandler, QXmlEntityResolver, QXmlErrorHandler и QXmlLexicalHandler), которые вы должны переопределить, если хотите обрабатывать содержимое.

Поскольку классы обработчиков описывают только интерфейсы, вы должны реализовать все функции. Мы предоставляем класс QXmlDefaultHandler, чтобы упростить задачу: он реализует поведение по умолчанию (ничего не делать) для всех функций, так что вы можете наследоваться от него и реализовывать только интересующие вас функции.

Функции и свойства ридера можно задать с помощью setFeature() и setProperty() соответственно. Вы можете установить ридер для использования своих собственных подклассов с помощью setEntityResolver(), setDTDHandler(), setContentHandler(), setErrorHandler(), setLexicalHandler() и setDeclHandler(). Само чтение запускается вызовом parse().

Обратите внимание, что этот класс теперь устарел, пожалуйста, используйте QXmlStreamReader или QDomDocument для чтения XML-файлов.

См. также QXmlSimpleReader.

Документация по членам-функциям

[virtual] QXmlReader::~QXmlReader()

Удаляет ридер.

[pure virtual] QXmlDTDHandler *QXmlReader::DTDHandler() const

Возвращает обработчик DTD или nullptr, если он не был задан.

См. также setDTDHandler().

[pure virtual] QXmlContentHandler *QXmlReader::contentHandler() const

Возвращает обработчик содержимого или nullptr, если он не был задан.

См. также setContentHandler().

[pure virtual] QXmlDeclHandler *QXmlReader::declHandler() const

Возвращает обработчик объявлений или nullptr, если он не был задан.

См. также setDeclHandler().

[pure virtual] QXmlEntityResolver *QXmlReader::entityResolver() const

Возвращает обработчик сущностей или nullptr, если он не был задан.

См. также setEntityResolver().

[pure virtual] QXmlErrorHandler *QXmlReader::errorHandler() const

Возвращает обработчик ошибок или nullptr, если он не задан.

См. также setErrorHandler().

[pure virtual] bool QXmlReader::feature(const QString &name, bool *ok = nullptr) const

Если у ридера есть функция с именем name, возвращается значение функции. Если такой функции не существует, возвращаемое значение неопределено.

Если ok не nullptr: *ok устанавливается в true, если у ридера есть функция с именем name; в противном случае *ok устанавливается в false.

См. также setFeature() и hasFeature().

[pure virtual] bool QXmlReader::hasFeature(const QString &name) const

Возвращает true, если у ридера есть функция с именем name; в противном случае возвращает false.

См. также feature() и setFeature().

[pure virtual] bool QXmlReader::hasProperty(const QString &name) const

Возвращает true, если у ридера есть свойство name; в противном случае возвращает false.

См. также property() и setProperty().

[pure virtual] QXmlLexicalHandler *QXmlReader::lexicalHandler() const

Возвращает обработчик лексических данных или nullptr если таковой не задан.

См. также setLexicalHandler().

[pure virtual] bool QXmlReader::parse(const QXmlInputSource *input)

Читает XML-документ из input и парсит его. Возвращает true если парсинг прошёл успешно; в противном случае возвращает false.

[pure virtual] void *QXmlReader::property(const QString &name, bool *ok = nullptr) const

Если у ридера есть свойство name, эта функция возвращает значение свойства; в противном случае возвращаемое значение неопределено.

Если ok не nullptr: если у ридера есть свойство name *ok устанавливается в true; в противном случае *ok устанавливается в false.

См. также setProperty() и hasProperty().

[pure virtual] void QXmlReader::setContentHandler(QXmlContentHandler *handler)

Устанавливает обработчик содержимого в handler.

См. также contentHandler().

[pure virtual] void QXmlReader::setDTDHandler(QXmlDTDHandler *handler)

Устанавливает обработчик DTD в handler.

См. также DTDHandler().

[pure virtual] void QXmlReader::setDeclHandler(QXmlDeclHandler *handler)

Устанавливает обработчик деклараций в handler.

См. также declHandler().

[pure virtual] void QXmlReader::setEntityResolver(QXmlEntityResolver *handler)

Устанавливает обработчик сущностей в handler.

См. также entityResolver().

[pure virtual] void QXmlReader::setErrorHandler(QXmlErrorHandler *handler)

Устанавливает обработчик ошибок в handler. Очищает обработчик ошибок, если handler равен 0.

См. также errorHandler().

[pure virtual] void QXmlReader::setFeature(const QString &name, bool value)

Устанавливает свойство name в заданное значение value. Если у ридера нет данного свойства, ничего не происходит.

См. также feature() и hasFeature().

[pure virtual] void QXmlReader::setLexicalHandler(QXmlLexicalHandler *handler)

Устанавливает обработчик лексических данных в handler.

См. также lexicalHandler().

[pure virtual] void QXmlReader::setProperty(const QString &name, void *value)

Устанавливает свойство name в значение value. Если у ридера нет данного свойства, ничего не происходит.

См. также property() и hasProperty().