En esta página

QXmlInputSource Class

La clase `QXmlInputSource` proporciona los datos de entrada para las subclases de ` QXmlReader `. Más información...

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

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QXmlInputSource()
QXmlInputSource(QIODevice *dev)
virtual ~QXmlInputSource()
virtual QString data() const
virtual void fetchData()
virtual QChar next()
virtual void reset()
virtual void setData(const QString &dat)
virtual void setData(const QByteArray &dat)

Funciones protegidas

virtual QString fromRawData(const QByteArray &data, bool beginning = false)

Descripción detallada

Todas las subclases de ` QXmlReader ` leen el documento XML de entrada desde esta clase.

Esta clase reconoce la codificación de los datos leyendo la declaración de codificación del archivo XML, si la encuentra, y leyendo los datos utilizando la codificación correspondiente. Si no encuentra una declaración de codificación, asume que los datos están en UTF-8 o UTF-16, dependiendo de si encuentra una marca de orden de bytes.

Hay dos formas de rellenar la fuente de entrada con datos: se puede crear con un ` QIODevice*` para que la fuente de entrada lea los datos de ese dispositivo, o bien se pueden establecer los datos explícitamente con una de las funciones ` setData()`.

Normalmente, se crea un `QXmlInputSource` que funcione con un ` QIODevice*` o se crea un `QXmlInputSource` vacío y se establecen los datos con ` setData()`. Solo en contadas ocasiones se querría combinar ambos métodos.

Las subclases de QXmlReader utilizan la función next() para leer la entrada carácter por carácter. Si quieres volver a empezar desde el principio, utiliza reset().

Las funciones data() y fetchData() resultan útiles si se desea realizar alguna operación con los datos además del análisis, por ejemplo, mostrar el archivo XML sin procesar. La ventaja de utilizar QXmlInputClass en estos casos es que intenta emplear la codificación correcta.

Véase también QXmlReader y QXmlSimpleReader.

Documentación de las funciones de miembro

QXmlInputSource::QXmlInputSource()

Crea una fuente de entrada que no contiene datos.

Véase también setData().

[explicit] QXmlInputSource::QXmlInputSource(QIODevice *dev)

Crea una fuente de entrada y obtiene los datos del dispositivo dev. Si dev no está abierto, se abre en modo de solo lectura. Si dev es 0 o no es posible leer desde el dispositivo, la fuente de entrada no contendrá datos.

Véase también setData(), fetchData() y QIODevice.

[virtual noexcept] QXmlInputSource::~QXmlInputSource()

Destructor.

[virtual] QString QXmlInputSource::data() const

Devuelve los datos que contiene la fuente de entrada o una cadena vacía si la fuente de entrada no contiene ningún dato.

Véase también setData(), QXmlInputSource() y fetchData().

[virtual] void QXmlInputSource::fetchData()

Esta función lee más datos del dispositivo que se especificó durante la creación. Si la fuente de entrada ya contenía datos, esta función los borra primero.

Este objeto no contiene datos tras llamar a esta función si se creó sin un dispositivo del que leer datos o si esta función no ha podido obtener más datos del dispositivo.

Hay dos ocasiones en las que otra llamada a una función realiza una recuperación de forma implícita: durante la creación (para que el objeto comience con algunos datos iniciales, cuando estén disponibles) y durante una llamada a next() (si se han agotado los datos).

Normalmente no es necesario utilizar esta función si se utiliza next().

Véanse también data(), next() y QXmlInputSource().

[virtual protected] QString QXmlInputSource::fromRawData(const QByteArray &data, bool beginning = false)

Esta función lee el archivo XML desde data e intenta reconocer la codificación. Convierte los datos sin procesar data en un QString y lo devuelve. Hace todo lo posible por obtener la codificación correcta para el archivo XML.

Si beginning es verdadero, esta función asume que los datos comienzan al inicio de un nuevo documento XML y busca una declaración de codificación. Si beginning es falso, convierte los datos sin procesar utilizando la codificación determinada a partir de llamadas anteriores.

[virtual] QChar QXmlInputSource::next()

Devuelve el siguiente carácter de la fuente de entrada. Si esta función llega al final de los datos disponibles, devuelve QXmlInputSource::EndOfData. Si se llama a next() después de eso, intenta obtener más datos llamando a fetchData(). Si la llamada a ` fetchData()` devuelve nuevos datos, esta función devuelve el primer carácter de dichos datos; de lo contrario, devuelve `QXmlInputSource::EndOfDocument`.

Los lectores, como ` QXmlSimpleReader`, asumirán que se ha llegado al final del documento XML si esta función devuelve `QXmlInputSource::EndOfDocument`, y comprobarán que la entrada proporcionada esté bien formada. Por lo tanto, al reimplementar esta función, es importante asegurarse de que se reproduzca este comportamiento.

Véase también reset(), fetchData(), QXmlSimpleReader::parse() y QXmlSimpleReader::parseContinue().

[virtual] void QXmlInputSource::reset()

Esta función establece la posición que utiliza next() en el inicio de los datos devueltos por data(). Esto resulta útil si se desea utilizar la fuente de entrada para más de un análisis.

Nota: En el caso de que la fuente de datos subyacente sea un QIODevice, la posición actual en el dispositivo no se establece automáticamente al inicio de la entrada. Para ello, llama a QIODevice::seek(0) en el dispositivo.

Véase también next().

[virtual] void QXmlInputSource::setData(const QString &dat)

Establece los datos de la fuente de entrada en dat.

Si la fuente de entrada ya contiene datos, esta función los elimina primero.

Véase también data().

[virtual] void QXmlInputSource::setData(const QByteArray &dat)

El dato « dat » se procesa mediante el códec de texto adecuado antes de asignarse.

Se trata de una función sobrecargada.

© 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.