Funciones de archivos y flujos de datos

La clase ` QIODevice ` es la clase de interfaz base de todos los dispositivos de E/S en Qt Core. QIODevice proporciona tanto una implementación común como una interfaz abstracta para dispositivos que admiten la lectura y escritura de bloques de datos. El dispositivo puede ser un búfer de memoria, un archivo o un flujo de datos.

Algunas subclases, como ` QFile `, se han implementado utilizando un búfer de memoria para el almacenamiento intermedio de datos. Esto acelera los programas al reducir las operaciones de lectura y escritura. El almacenamiento en búfer agiliza funciones como ` getChar()` y ` putChar()`, ya que pueden operar sobre el búfer de memoria en lugar de hacerlo directamente sobre el propio dispositivo.

La clase ` QFile ` proporciona funciones para leer y escribir en archivos. Un ` QFile ` puede utilizarse por sí solo o, de forma más práctica, junto con un ` QTextStream ` o un ` QDataStream`.

QBuffer permite acceder a un ` QByteArray ` mediante la interfaz ` QIODevice `. El ` QByteArray ` se trata como un archivo estándar de acceso aleatorio. Un ejemplo:

QBuffer buffer;
char ch;

buffer.open(QBuffer::ReadWrite);
buffer.write("Qt rocks!");
buffer.seek(0);
buffer.getChar(&ch);  // ch == 'Q'
buffer.getChar(&ch);  // ch == 't'
buffer.getChar(&ch);  // ch == ' '
buffer.getChar(&ch);  // ch == 'r'

Llama a ` open()` para abrir el búfer. A continuación, llama a ` write()` o ` putChar()` para escribir en el búfer, y a ` read()`, ` readLine()`, ` readAll()` o ` getChar()` para leerlo. ` size()` devuelve el tamaño actual del búfer, y puedes desplazarte a posiciones arbitrarias en el búfer llamando a ` seek()`. Cuando hayas terminado de acceder al búfer, llama a close().

La clase ` QDataStream ` permite la serialización de datos binarios en un ` QIODevice`. Un flujo de datos es un flujo binario de información codificada que es 100 % independiente del sistema operativo, la CPU o el orden de los bytes del ordenador host. Por ejemplo, un flujo de datos escrito por un PC con Windows puede ser leído por un Sun SPARC que ejecute Solaris. También puedes utilizar un flujo de datos para leer o escribir datos binarios sin codificar.

Para obtener más detalles sobre los tipos de datos que QDataStream puede serializar, consulta «Serialización de tipos de datos de Qt».

La clase ` QTextStream ` proporciona una interfaz práctica para leer y escribir texto. ` QTextStream ` puede operar sobre un ` QIODevice`, un ` QByteArray ` o un ` QString`. Mediante los operadores de flujo de ` QTextStream`, se pueden leer y escribir cómodamente palabras, líneas y números. También es habitual utilizar ` QTextStream ` para leer la entrada de la consola y escribir la salida de la consola.

Existen tres formas generales de utilizar QTextStream al leer archivos de texto:

  • Por fragmentos, llamando a ` readLine()` o ` readAll()`.
  • Palabra por palabra. QTextStream admite la transmisión a QStrings, QByteArrays y búferes de tipo char*. Las palabras están delimitadas por espacios, y los espacios en blanco iniciales se omiten automáticamente.
  • Carácter a carácter, mediante la transmisión a tipos ` QChar ` o `char`. Este método se utiliza a menudo para facilitar el manejo de la entrada al analizar archivos, independientemente de la codificación de caracteres y la semántica de fin de línea. Para omitir los espacios en blanco, llama a ` skipWhiteSpace()`.

QByteArray Se puede utilizar para almacenar tanto bytes sin procesar (incluidos los de tipo ` \0`) como cadenas tradicionales de 8 bits terminadas en «\0 ». El uso de ` QByteArray ` resulta mucho más cómodo que el de `const char *`. Garantiza siempre que los datos vayan seguidos de un terminador «\0 » y utiliza clases compartidas implícitamente (copia al escribir) para reducir el uso de memoria y evitar copias innecesarias de datos.

Además de ` QByteArray`, Qt también proporciona la clase ` QString ` para almacenar datos de cadena. Para la mayoría de los casos, QString es la clase más adecuada. Almacena caracteres Unicode de 16 bits. Sin embargo, es recomendable utilizar QByteArray cuando se necesiten almacenar datos binarios sin procesar y cuando el ahorro de memoria sea fundamental (por ejemplo, con Qt para Linux embebido).

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