Transmisión de XML

Qt proporciona dos clases para leer y escribir XML a través de una sencilla API de transmisión: QXmlStreamReader y QXmlStreamWriter. Estas clases se encuentran en Qt Serialization (parte de QtCore).

Un lector de flujos presenta un documento XML como un flujo de tokens. Esto difiere de SAX, ya que las aplicaciones SAX proporcionan controladores para recibir eventos XML del analizador, mientras que QXmlStreamReader controla el bucle, extrayendo tokens del lector cuando son necesarios. Este enfoque de extracción permite crear analizadores recursivos descendentes, lo que permite dividir el código de análisis XML en diferentes métodos o clases.

QXmlStreamReader es un analizador de XML 1.0 bien formado que excluye las entidades analizadas externas. Por lo tanto, los datos proporcionados por el lector de flujos cumplen los criterios del W3C para un XML bien formado, siempre que no se produzca ningún error. De lo contrario, se pueden utilizar funciones como ` atEnd()`, ` error()` y ` hasError()` para comprobar y visualizar los errores.

Un ejemplo de implementación que utiliza QXmlStreamReader sería el XbelReader del ejemplo «QXmlStream Bookmarks», que envuelve un QXmlStreamReader. Lee la implementación para obtener más información sobre cómo utilizar la clase QXmlStreamReader.

Junto con ` QXmlStreamReader ` se encuentra la clase ` QXmlStreamWriter `, que proporciona a un escritor de XML una sencilla API de streaming. ` QXmlStreamWriter ` opera sobre un ` QIODevice ` y cuenta con funciones especializadas para todos los tokens o eventos XML que se deseen escribir, tales como ` writeDTD()`, ` writeCharacters()`, ` writeComment()` y así sucesivamente.

Para escribir un documento XML con QXmlStreamWriter, se inicia el documento con la función writeStartDocument() y se termina con writeEndDocument(), lo que cierra implícitamente todas las etiquetas que queden abiertas. Las etiquetas de los elementos se abren con writeStartDocument() y van seguidas de writeAttribute() o writeAttributes(), el contenido del elemento y, a continuación, writeEndDocument(). Además, se puede utilizar writeEmptyElement() para escribir elementos vacíos.

El contenido de un elemento está compuesto por caracteres, referencias de entidad o elementos anidados. El contenido se puede escribir con ` writeCharacters()` (una función que también se encarga de escapar todos los caracteres y secuencias de caracteres prohibidos), ` writeEntityReference()` o mediante llamadas sucesivas a ` writeStartElement()`.

La clase `XbelWriter ` del ejemplo «Bookmarks» de QXmlStream envuelve un objeto ` QXmlStreamWriter`. Consulta la implementación para ver cómo utilizar la clase ` QXmlStreamWriter `.

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