En esta página

Entrada y salida de datos

Esta página ofrece una visión general de las distintas formas de recuperar y guardar datos utilizando Qt.

Guardar y cargar datos

La clase ` QIODevice ` es la clase base para todos los dispositivos de almacenamiento de archivos y datos en Qt Core. Todas las clases que se utilizan para leer y escribir datos heredan de ella.

Algunos ejemplos de dispositivos son ` QFile`, ` QBuffer`, ` QTcpSocket` y ` QProcess`. ` QFile ` se utiliza para leer y escribir texto, archivos binarios y recursos, mediante la interfaz ` QIODevice `. Un ` QFile ` puede utilizarse por sí solo o, de forma más cómoda, junto con un ` QTextStream ` o un ` QDataStream`.

La clase ` QBuffer ` proporciona una interfaz ` QIODevice ` para un ` QByteArray`. ` QTcpSocket ` permite al desarrollador establecer una conexión TCP y transferir flujos de datos. ` QProcess ` se utiliza para iniciar programas externos, así como para leer y escribir en dicho proceso.

Datos serializados

La API de Qt ofrece soporte para la serialización de datos en varios casos de uso.

Base de datos

El Qt SQL módulo utiliza complementos de controladores para comunicarse con varias API de bases de datos. Qt dispone de controladores para SQLite, MySQL, DB2, Borland InterBase, Oracle, ODBC y PostgreSQL. También es posible desarrollar tu propio controlador si Qt no proporciona el necesario.

Las clases SQL de Qt se pueden dividir en tres capas:

CapaFinalidadClase de ejemplo
  • Capa de controladores
  • Capa de API de SQL
  • Capa de interfaz de usuario
  • Comunicación de bajo nivel entre la base de datos y la capa de API SQL
  • Proporcionar acceso a las bases de datos
  • Vincular datos de una base de datos a widgets que gestionan datos

Con todos los controladores SQL, a excepción de SQLite, puede conectarse a un servidor que aloje su sistema de base de datos. Si utiliza el servidor MySQL integrado, no necesita un servidor MySQL para utilizar ese sistema de base de datos.

Para obtener instrucciones sobre cómo compilar los controladores de bases de datos SQL, consulta «Controladores de bases de datos SQL».

El complemento Qt SQLite es muy adecuado para el almacenamiento local. SQLite es un sistema de gestión de bases de datos relacionales contenido en una pequeña biblioteca C (~350 KiB). A diferencia de otros sistemas de gestión de bases de datos, SQLite no es un proceso independiente al que se accede desde la aplicación cliente, sino una parte integral de la misma. SQLite opera sobre un único archivo, que debe establecerse como nombre de la base de datos al abrir una conexión. Si el archivo no existe, SQLite intentará crearlo.

SQLite presenta algunas restricciones en lo que respecta a usuarios múltiples y transacciones múltiples. Si se lee o se escribe en un archivo desde transacciones diferentes, la aplicación podría bloquearse hasta que una de las transacciones se confirme o se revierta.

Una vez configurado el controlador, se puede acceder a los datos mediante las clases QSqlQueryModel, QSqlTableModel y QSqlRelationalTableModel. QSqlTableModel y QSqlRelationalTableModel proporcionan modelos editables que pueden utilizarse con las vistas de elementos de Qt. QSqlTableModel tiene acceso de lectura/escritura a una sola tabla, mientras que QSqlRelationalTableModel tiene acceso de lectura/escritura a la tabla principal (no a la tabla con la clave foránea).

Las siguientes páginas contienen información sobre cómo incorporar SQL en las aplicaciones:

Compatibilidad con XML en Qt

Qt proporciona interfaces de programación de aplicaciones (API) para leer y analizar flujos XML, así como para escribir en dichos flujos. Las siguientes clases clave facilitan estas acciones al proporcionar la infraestructura necesaria:

  • QDomDocument La clase representa todo el documento XML como un árbol de documento y proporciona el acceso principal a los datos del documento.
  • QXmlStreamReader La clase proporciona un analizador para leer XML. Se trata de un analizador de XML 1.0 bien formado que no incluye entidades analizadas externas.
    • Reconoce y resuelve los espacios de nombres XML. Por ejemplo, en el caso de un StartElement, namespaceUri() devuelve el espacio de nombres en el que se encuentra el elemento, y name() devuelve el nombre local del elemento. La combinación de namespaceUri() y name() identifica de forma única a un elemento.
    • No supone una carga elevada para la CPU, ya que no almacena todo el árbol del documento XML en memoria. Solo almacena el token actual en el momento en que se indica.
  • La clase ` QXmlStreamWriter ` proporciona a un escritor de XML una sencilla API de streaming. Es la contrapartida de ` QXmlStreamReader ` para escribir XML, y opera sobre un ` QIODevice ` especificado con `setDevice()`.
    • Se trata de una API sencilla que proporciona una función específica para cada token o evento XML que se desee escribir.
    • Se encarga de añadir prefijos a los espacios de nombres en función del namespaceUri especificado al escribir elementos o atributos. Si es necesario utilizar determinados prefijos estandarizados, se puede obligar al escritor a utilizarlos declarando los espacios de nombres manualmente mediante writeNamespace() o writeDefaultNamespace().
    • Puede dar formato automáticamente a los datos XML generados añadiendo saltos de línea y sangría, lo que los hace más legibles. Esta función se puede activar mediante la propiedad de formato automático.

Los siguientes temas ofrecen más información sobre la compatibilidad con « Qt XML »:

JSON en Qt

JSON es un estándar abierto basado en texto para el intercambio de datos que resulta fácil de leer y analizar. Se utiliza para representar estructuras de datos sencillas y matrices asociativas, denominadas «objetos». Está relacionado con JavaScript, pero es una forma de notación independiente del lenguaje.

Un objeto puede adoptar dos formas:

Colección de pares nombre/valorLista ordenada de valores
{
          "last_name": "Routledge",
          "first_name": "Ronald",
          "birth_date": 1960
}
"colors": ["green", "blue", "yellow"]

Almacenamiento local

La API de almacenamiento local permite acceder al almacenamiento local sin conexión en una base de datos SQL desde QML y JavaScript.

Estas bases de datos son específicas de cada usuario y de QML, pero son accesibles para todas las aplicaciones QML. Se almacenan en el subdirectorio «Databases» de QDeclarativeEngine::offlineStoragePath() como bases de datos SQLite (controladores de bases de datos SQL).

La API se ajusta a la API síncrona de la API de bases de datos web de HTML5, borrador de trabajo del W3C del 29 de octubre de 2009 (API de bases de datos web de HTML5).

Consulta «Ejemplos de la API de almacenamiento local deQt Quick » para ver una demostración básica del uso de la API de almacenamiento local.

Clase QSettings

La clase QSettings proporciona almacenamiento persistente de la configuración de la aplicación. Normalmente, una aplicación recuerda su configuración de la sesión anterior.

La configuración se almacena de forma diferente en cada plataforma. Por ejemplo, en Windows se almacena en el registro, mientras que en macOS se almacena en archivos XML.

QSettings te permiten guardar y restaurar la configuración de la aplicación de forma portátil. La creación y destrucción de un objeto ` QSettings ` es ligera y rápida. Al crear un objeto de ` QSettings`, es recomendable especificar no solo el nombre de la aplicación, sino también el nombre de tu organización. Por ejemplo:

QSettings settings("MyCompany", "Accountancy");

Recursos

El sistema de recursos de Qt es un mecanismo independiente de la plataforma que permite almacenar archivos binarios en el ejecutable de la aplicación. Esto resulta útil si tu aplicación necesita con frecuencia un archivo concreto o un conjunto de archivos. Además, protege contra la pérdida de ese archivo en particular.

Los datos de los recursos pueden compilarse en el binario y consultarse inmediatamente en el código de la aplicación, o bien la aplicación puede crear un recurso binario de forma dinámica y registrarlo en el sistema de recursos.

Por defecto, se puede acceder a los recursos desde el código de la aplicación mediante el mismo nombre de archivo con el que se almacenan en el árbol de fuentes, con el prefijo :/, o mediante una URL con el esquema qrc.

Conectividad

Archivado de archivos

Un archivo comprimido es una colección de archivos o directorios que, por lo general, se comprimen para reducir el espacio que, de otro modo, ocuparían en una unidad de almacenamiento. Algunos ejemplos de archivos comprimidos son ZIP, TAR, RAR y 7z.

Qt es compatible con los archivos creados con zlib (véanse qCompress() y qUncompress()).

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