En esta página

QXmlReader Class

La clase QXmlReader proporciona una interfaz para lectores de XML (es decir, analizadores sintácticos). Más información...

Encabezado: #include <QXmlReader>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core5Compat)
target_link_libraries(mytarget PRIVATE Qt6::Core5Compat)
qmake: QT += core5compat
Heredado por:

QXmlSimpleReader

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

virtual ~QXmlReader()
virtual QXmlDTDHandler *DTDHandler() const = 0
virtual QXmlContentHandler *contentHandler() const = 0
virtual QXmlDeclHandler *declHandler() const = 0
virtual QXmlEntityResolver *entityResolver() const = 0
virtual QXmlErrorHandler *errorHandler() const = 0
virtual bool feature(const QString &name, bool *ok = nullptr) const = 0
virtual bool hasFeature(const QString &name) const = 0
virtual bool hasProperty(const QString &name) const = 0
virtual QXmlLexicalHandler *lexicalHandler() const = 0
virtual bool parse(const QXmlInputSource *input) = 0
virtual void *property(const QString &name, bool *ok = nullptr) const = 0
virtual void setContentHandler(QXmlContentHandler *handler) = 0
virtual void setDTDHandler(QXmlDTDHandler *handler) = 0
virtual void setDeclHandler(QXmlDeclHandler *handler) = 0
virtual void setEntityResolver(QXmlEntityResolver *handler) = 0
virtual void setErrorHandler(QXmlErrorHandler *handler) = 0
virtual void setFeature(const QString &name, bool value) = 0
virtual void setLexicalHandler(QXmlLexicalHandler *handler) = 0
virtual void setProperty(const QString &name, void *value) = 0

Descripción detallada

Esta clase abstracta proporciona una interfaz para todos los lectores de XML de Qt. Actualmente solo hay una implementación de un lector incluida en el módulo Qt XML: QXmlSimpleReader. En futuras versiones podría haber más lectores disponibles con diferentes propiedades (por ejemplo, un analizador con validación).

El diseño de las clases XML sigue la interfaz SAX2 de Java, con los nombres adaptados a las convenciones de nomenclatura de Qt. A cualquier persona que haya trabajado con SAX2 le resultará muy fácil empezar a utilizar las clases Qt XML.

Todos los lectores utilizan la clase ` QXmlInputSource ` para leer el documento de entrada. Dado que normalmente te interesa un contenido concreto del documento XML, el lector devuelve dicho contenido a través de clases de controlador especiales (`QXmlDTDHandler`, ` QXmlDeclHandler`, ` QXmlContentHandler`, ` QXmlEntityResolver`, ` QXmlErrorHandler ` y ` QXmlLexicalHandler`), de las que debes crear subclases si deseas procesar el contenido.

Dado que las clases de controladores solo describen interfaces, debes implementar todas las funciones. Para facilitar esta tarea, proporcionamos la clase ` QXmlDefaultHandler `: esta implementa un comportamiento por defecto (no hacer nada) para todas las funciones, de modo que puedes crear una subclase de la misma e implementar únicamente las funciones que te interesen.

Las características y propiedades del lector se pueden configurar con setFeature() y setProperty(), respectivamente. Puedes configurar el lector para que utilice tus propias subclases con setEntityResolver(), setDTDHandler(), setContentHandler(), setErrorHandler(), setLexicalHandler() y setDeclHandler(). El análisis en sí se inicia con una llamada a parse().

Ten en cuenta que esta clase ya está obsoleta; utiliza QXmlStreamReader o QDomDocument para leer archivos XML.

Véase también QXmlSimpleReader.

Documentación de las funciones de miembro

[virtual noexcept] QXmlReader::~QXmlReader()

Deja al lector sin palabras.

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

Devuelve el controlador DTD o nullptr si no se ha establecido ninguno.

Véase también setDTDHandler().

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

Devuelve el gestor de contenido o « nullptr » si no se ha establecido ninguno.

Véase también setContentHandler().

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

Devuelve el controlador de declaraciones o nullptr si no se ha establecido ninguno.

Véase también setDeclHandler().

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

Devuelve el resolutor de entidades o nullptr si no se ha configurado ninguno.

Véase también setEntityResolver().

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

Devuelve el gestor de errores o nullptr si no hay ninguno configurado.

Véase también setErrorHandler().

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

Si el lector dispone de la característica denominada « name », se devuelve el valor de dicha característica. Si no existe dicha característica, el valor devuelto es indefinido.

Si « ok » no es « nullptr »: *ok se establece en «true» si el lector dispone de la característica denominada « name »; en caso contrario, *ok se establece en «false».

Véase también setFeature() y hasFeature().

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

Devuelve « true » si el lector dispone de la característica denominada « name »; en caso contrario, devuelve « false ».

Véanse también feature() y setFeature().

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

Devuelve ` true ` si el lector tiene la propiedad ` name`; en caso contrario, devuelve ` false`.

Véase también property() y setProperty().

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

Devuelve el controlador léxico o ` nullptr ` si no se ha establecido ninguno.

Véase también setLexicalHandler().

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

Lee un documento XML desde input y lo analiza. Devuelve true si el análisis se ha realizado correctamente; en caso contrario, devuelve false.

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

Si el lector tiene la propiedad name, esta función devuelve el valor de dicha propiedad; en caso contrario, el valor devuelto es indefinido.

Si ok no es nullptr: si el lector tiene la propiedad name * ok se establece en true; en caso contrario, *ok se establece en false.

Véase también setProperty() y hasProperty().

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

Establece el gestor de contenido en handler.

Véase también contentHandler().

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

Establece el gestor de DTD en handler.

Véase también DTDHandler().

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

Establece el gestor de declaraciones en handler.

Véase también declHandler().

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

Establece el resolutor de entidades en handler.

Véase también entityResolver().

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

Establece el gestor de errores en handler. Borra el gestor de errores si handler es 0.

Véase también errorHandler().

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

Establece la característica denominada « name » en el valor indicado value. Si el lector no dispone de dicha característica, no ocurre nada.

Véase también feature() y hasFeature().

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

Establece el controlador léxico en « handler ».

Véase también lexicalHandler().

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

Establece la propiedad « name » en « value ». Si el lector no tiene esta propiedad, no ocurre nada.

Véase también property() y hasProperty().

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.