QTextStream Class
La clase QTextStream ofrece una interfaz práctica para leer y escribir texto. Más...
| Encabezado: | #include <QTextStream> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QIODeviceBase |
- Lista de todos los miembros, incluidos los heredados
- Miembros obsoletos
- QTextStream forma parte de Entrada/Salida y Redes y de Clases para datos de cadena.
Nota: Todas las funciones de esta clase son reentrantes.
Tipos públicos
| enum | FieldAlignment { AlignLeft, AlignRight, AlignCenter, AlignAccountingStyle } |
| enum | NumberFlag { ShowBase, ForcePoint, ForceSign, UppercaseBase, UppercaseDigits } |
| flags | NumberFlags |
| enum | RealNumberNotation { ScientificNotation, FixedNotation, SmartNotation } |
| enum | Status { Ok, ReadPastEnd, ReadCorruptData, WriteFailed } |
Funciones públicas
| QTextStream() | |
| QTextStream(QIODevice *device) | |
| QTextStream(FILE *fileHandle, QIODeviceBase::OpenMode openMode = ReadWrite) | |
| QTextStream(QByteArray *array, QIODeviceBase::OpenMode openMode = ReadWrite) | |
| QTextStream(QString *string, QIODeviceBase::OpenMode openMode = ReadWrite) | |
| QTextStream(const QByteArray &array, QIODeviceBase::OpenMode openMode = ReadOnly) | |
| virtual | ~QTextStream() |
| bool | atEnd() const |
| bool | autoDetectUnicode() const |
| QIODevice * | device() const |
| QStringConverter::Encoding | encoding() const |
| QTextStream::FieldAlignment | fieldAlignment() const |
| int | fieldWidth() const |
| void | flush() |
| bool | generateByteOrderMark() const |
| int | integerBase() const |
| QLocale | locale() const |
| QTextStream::NumberFlags | numberFlags() const |
| QChar | padChar() const |
| qint64 | pos() const |
| QString | read(qint64 maxlen) |
| QString | readAll() |
| QString | readLine(qint64 maxlen = 0) |
| bool | readLineInto(QString *line, qint64 maxlen = 0) |
| QTextStream::RealNumberNotation | realNumberNotation() const |
| int | realNumberPrecision() const |
| void | reset() |
| void | resetStatus() |
| bool | seek(qint64 pos) |
| void | setAutoDetectUnicode(bool enabled) |
| void | setDevice(QIODevice *device) |
(since 6.0) void | setEncoding(QStringConverter::Encoding encoding) |
| void | setFieldAlignment(QTextStream::FieldAlignment mode) |
| void | setFieldWidth(int width) |
| void | setGenerateByteOrderMark(bool generate) |
| void | setIntegerBase(int base) |
| void | setLocale(const QLocale &locale) |
| void | setNumberFlags(QTextStream::NumberFlags flags) |
| void | setPadChar(QChar ch) |
| void | setRealNumberNotation(QTextStream::RealNumberNotation notation) |
| void | setRealNumberPrecision(int precision) |
| void | setStatus(QTextStream::Status status) |
| void | setString(QString *string, QIODeviceBase::OpenMode openMode = ReadWrite) |
| void | skipWhiteSpace() |
| QTextStream::Status | status() const |
| QString * | string() const |
(since 6.10) | operator bool() const |
| QTextStream & | operator<<(QChar c) |
| QTextStream & | operator<<(const QString &string) |
| QTextStream & | operator<<(float f) |
| QTextStream & | operator<<(short i) |
| QTextStream & | operator<<(QLatin1StringView string) |
| QTextStream & | operator<<(QStringView string) |
| QTextStream & | operator<<(char c) |
(since 6.3.1) QTextStream & | operator<<(char16_t c) |
| QTextStream & | operator<<(const QByteArray &array) |
| QTextStream & | operator<<(const char *string) |
| QTextStream & | operator<<(const void *ptr) |
| QTextStream & | operator<<(double f) |
| QTextStream & | operator<<(int i) |
| QTextStream & | operator<<(long i) |
| QTextStream & | operator<<(qlonglong i) |
| QTextStream & | operator<<(qulonglong i) |
| QTextStream & | operator<<(unsigned int i) |
| QTextStream & | operator<<(unsigned long i) |
| QTextStream & | operator<<(unsigned short i) |
| QTextStream & | operator>>(QChar &c) |
| QTextStream & | operator>>(QString &str) |
| QTextStream & | operator>>(float &f) |
| QTextStream & | operator>>(short &i) |
| QTextStream & | operator>>(QByteArray &array) |
| QTextStream & | operator>>(char &c) |
(since 6.4) QTextStream & | operator>>(char16_t &c) |
| QTextStream & | operator>>(double &f) |
| QTextStream & | operator>>(int &i) |
| QTextStream & | operator>>(long &i) |
| QTextStream & | operator>>(qlonglong &i) |
| QTextStream & | operator>>(qulonglong &i) |
| QTextStream & | operator>>(unsigned int &i) |
| QTextStream & | operator>>(unsigned long &i) |
| QTextStream & | operator>>(unsigned short &i) |
Elementos no miembros relacionados
| QTextStreamManipulator | qSetFieldWidth(int width) |
| QTextStreamManipulator | qSetPadChar(QChar ch) |
| QTextStreamManipulator | qSetRealNumberPrecision(int precision) |
Descripción detallada
QTextStream puede operar sobre un ` QIODevice`, un ` QByteArray ` o un ` QString`. Mediante los operadores de flujo de QTextStream, se pueden leer y escribir palabras, líneas y números de forma cómoda. Para generar texto, QTextStream admite opciones de formato para el relleno y la alineación de campos, así como para el formato de números. Ejemplo:
QFile data("output.txt");
if (data.open(QFile::WriteOnly | QFile::Truncate)) {
QTextStream out(&data);
out << "Result: " << qSetFieldWidth(10) << Qt::left << 3.14 << 2.7;
// writes "Result: 3.14 2.7 "
}También es habitual utilizar QTextStream para leer entradas de la consola y escribir salidas en ella. QTextStream tiene en cuenta la configuración regional y decodificará automáticamente la entrada estándar utilizando la codificación correcta. Ejemplo:
QTextStream stream(stdin);
QString line;
while (stream.readLineInto(&line)) {
//...
}Además de utilizar los constructores de QTextStream, también puedes establecer el dispositivo o la cadena sobre la que opera QTextStream llamando a ` setDevice()` o ` setString()`. Puedes desplazarte a una posición llamando a ` seek()`, y ` atEnd()` devolverá «true» cuando no queden datos por leer. Si se invoca a ` flush()`, QTextStream vaciará todos los datos de su búfer de escritura en el dispositivo y llamará a ` flush()` en el dispositivo.
Internamente, QTextStream utiliza un búfer basado en Unicode, y QTextStream utiliza QStringConverter para admitir automáticamente diferentes codificaciones. Por defecto, se utiliza UTF-8 para la lectura y la escritura, pero también se puede establecer la codificación llamando a setEncoding(). También se admite la detección automática de Unicode. Cuando esta función está activada (comportamiento predeterminado), QTextStream detectará el BOM (Byte Order Mark) de UTF-8, UTF-16 o UTF-32 y cambiará a la codificación UTF adecuada durante la lectura. QTextStream no escribe un BOM de forma predeterminada, pero se puede habilitar llamando a ` setGenerateByteOrderMark(true)`. Cuando QTextStream opera directamente sobre un ` QString `, la codificación queda deshabilitada.
Existen tres formas generales de utilizar QTextStream al leer archivos de texto:
- Por fragmentos, llamando a ` readLine()` o ` readAll()`.
- Palabra a palabra. QTextStream admite la transmisión a QString, QByteArrayy búferes de tipo char*. Las palabras están delimitadas por espacios, y los espacios en blanco iniciales se omiten automáticamente.
- Carácter por carácter, mediante la transmisión a tipos ` QChar ` o `char`. Este método se utiliza a menudo para facilitar la gestión 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()`.
Dado que el flujo de texto utiliza un búfer, no debes leer desde el flujo utilizando la implementación de una superclase. Por ejemplo, si tienes un ` QFile ` y lees directamente desde él utilizando ` QFile::readLine()` en lugar de utilizar el flujo, la posición interna del flujo de texto quedará desincronizada con la posición del archivo.
Por defecto, al leer números de un flujo de texto, QTextStream detectará automáticamente la base de representación del número. Por ejemplo, si el número comienza por «0x», se supone que está en formato hexadecimal. Si comienza con los dígitos del 1 al 9, se supone que está en formato decimal, y así sucesivamente. Puedes establecer la base del entero, desactivando así la detección automática, llamando a ` setIntegerBase()`. Ejemplo:
QTextStream in("0x50 0x20");
int firstNumber, secondNumber;
in >> firstNumber; // firstNumber == 80
in >> Qt::dec >> secondNumber; // secondNumber == 0
char ch;
in >> ch; // ch == 'x'QTextStream admite numerosas opciones de formato para generar texto. Se puede establecer el ancho de campo y el carácter de relleno llamando a setFieldWidth() y setPadChar(). Utiliza setFieldAlignment() para establecer la alineación dentro de cada campo. Para los números reales, llama a setRealNumberNotation() y setRealNumberPrecision() para establecer la notación (SmartNotation, ScientificNotation, FixedNotation) y la precisión en dígitos del número generado. También hay disponibles algunas opciones adicionales de formato numérico a través de setNumberFlags().
Al igual que ` <iostream> ` en la biblioteca estándar de C++, `QTextStream` también define varias funciones manipuladoras globales:
Además, Qt proporciona tres manipuladores globales que admiten un parámetro: qSetFieldWidth(), qSetPadChar() y qSetRealNumberPrecision().
Véase también QDataStream, QIODevice, QFile, QBuffer y QTcpSocket.
Documentación sobre tipos de miembros
enum QTextStream::FieldAlignment
Esta enumeración especifica cómo alinear el texto en los campos cuando el campo es más ancho que el texto que ocupa.
| Constante | Valor | Descripción |
|---|---|---|
QTextStream::AlignLeft | 0 | Rellenar por la derecha de los campos. |
QTextStream::AlignRight | 1 | Alinea a la izquierda de los campos. |
QTextStream::AlignCenter | 2 | Alineación a ambos lados del campo. |
QTextStream::AlignAccountingStyle | 3 | Igual que AlignRight, salvo que el signo de un número queda alineado a la izquierda. |
Véase también setFieldAlignment().
enum QTextStream::NumberFlag
flags QTextStream::NumberFlags
Esta enumeración especifica varios indicadores que se pueden establecer para modificar la salida de números enteros, floats y doubles.
| Constante | Valor | Descripción |
|---|---|---|
QTextStream::ShowBase | 0x1 | Muestra la base como prefijo si la base es 16 («0x»), 8 («0») o 2 («0b»). |
QTextStream::ForcePoint | 0x2 | Incluye siempre el separador decimal en los números, aunque no haya decimales. |
QTextStream::ForceSign | 0x4 | Incluye siempre el signo en los números, incluso en los positivos. |
QTextStream::UppercaseBase | 0x8 | Utiliza las versiones en mayúsculas de los prefijos de base («0X», «0B»). |
QTextStream::UppercaseDigits | 0x10 | Utiliza letras mayúsculas para expresar los dígitos del 10 al 35 en lugar de minúsculas. |
El tipo NumberFlags es un typedef para QFlags<NumberFlag>. Almacena una combinación OR de valores de NumberFlag.
Véase también setNumberFlags().
enum QTextStream::RealNumberNotation
Esta enumeración especifica qué notaciones se deben utilizar para expresar « float » y « double » como cadenas de caracteres.
| Constante | Valor | Descripción |
|---|---|---|
QTextStream::ScientificNotation | 2 | Notación científica (indicador %e deprintf()). |
QTextStream::FixedNotation | 1 | Notación de punto fijo (indicador « %f » deprintf()). |
QTextStream::SmartNotation | 0 | Notación científica o de punto fijo, según cuál tenga más sentido (indicador ` %g ` de `printf()`). |
Véase también setRealNumberNotation().
enum QTextStream::Status
Esta enumeración describe el estado actual del flujo de texto.
| Constante | Valor | Descripción |
|---|---|---|
QTextStream::Ok | 0 | El flujo de texto funciona con normalidad. |
QTextStream::ReadPastEnd | 1 | El flujo de texto ha leído más allá del final de los datos del dispositivo subyacente. |
QTextStream::ReadCorruptData | 2 | El flujo de texto ha leído datos dañados. |
QTextStream::WriteFailed | 3 | El flujo de texto no puede escribir en el dispositivo subyacente. |
Véase también status().
Documentación de funciones miembro
QTextStream::QTextStream()
Crea un objeto QTextStream. Para poder utilizarlo para leer o escribir, primero debes asignarle un dispositivo o una cadena.
Véase también setDevice() y setString().
[explicit] QTextStream::QTextStream(QIODevice *device)
Crea un QTextStream que opera sobre un device.
[explicit] QTextStream::QTextStream(FILE *fileHandle, QIODeviceBase::OpenMode openMode = ReadWrite)
Crea un QTextStream que opera sobre un ` fileHandle`, utilizando ` openMode ` para definir el modo de apertura. Internamente, se crea un ` QFile ` para gestionar el puntero `FILE`.
Este constructor resulta útil para trabajar directamente con los flujos de entrada y salida comunes basados en FILE: stdin, stdout y stderr. Ejemplo:
QString str;
QTextStream in(stdin);
in >> str;[explicit] QTextStream::QTextStream(QByteArray *array, QIODeviceBase::OpenMode openMode = ReadWrite)
Crea un QTextStream que opera sobre un ` array`, utilizando ` openMode ` para definir el modo de apertura. Internamente, la matriz se envuelve en un ` QBuffer`.
[explicit] QTextStream::QTextStream(QString *string, QIODeviceBase::OpenMode openMode = ReadWrite)
Crea un QTextStream que opera sobre un ` string`, utilizando ` openMode ` para definir el modo de apertura.
[explicit] QTextStream::QTextStream(const QByteArray &array, QIODeviceBase::OpenMode openMode = ReadOnly)
Crea un QTextStream que opera sobre un ` array`, utilizando ` openMode ` para definir el modo de apertura. Se accede a la matriz como de solo lectura, independientemente de los valores contenidos en ` openMode`.
Este constructor resulta práctico para trabajar con cadenas constantes. Ejemplo:
int main(int argc, char *argv[])
{
// read numeric arguments (123, 0x20, 4.5...)
for (int i = 1; i < argc; ++i) {
int number;
QTextStream in(argv[i]);
in >> number;
//...
}
}[virtual noexcept] QTextStream::~QTextStream()
Destruye la clase ` QTextStream`.
Si el flujo se ejecuta en un dispositivo, se llamará implícitamente a flush(). De lo contrario, el dispositivo no se ve afectado.
bool QTextStream::atEnd() const
Devuelve ` true ` si no hay más datos que leer del ` QTextStream`; en caso contrario, devuelve ` false`. Esto es similar, aunque no idéntico, a llamar a ` QIODevice::atEnd()`, ya que ` QTextStream ` también tiene en cuenta su búfer Unicode interno.
bool QTextStream::autoDetectUnicode() const
Devuelve « true » si la detección automática de Unicode está activada; en caso contrario, devuelve « false ». La detección automática de Unicode está activada por defecto.
Véase también setAutoDetectUnicode() y setEncoding().
QIODevice *QTextStream::device() const
Devuelve el dispositivo actual asociado a QTextStream, o nullptr si no se ha asignado ningún dispositivo.
Véase también setDevice() y string().
QStringConverter::Encoding QTextStream::encoding() const
Devuelve la codificación asignada actualmente al flujo.
Véase también setEncoding(), setAutoDetectUnicode() y locale().
QTextStream::FieldAlignment QTextStream::fieldAlignment() const
Devuelve la alineación actual del campo.
Véase también setFieldAlignment() y fieldWidth().
int QTextStream::fieldWidth() const
Devuelve la anchura actual del campo.
Véase también setFieldWidth().
void QTextStream::flush()
Vacía los datos almacenados en el búfer que están a la espera de ser escritos en el dispositivo.
Si se aplica la función ` QTextStream ` a una cadena, esta función no realiza ninguna acción.
bool QTextStream::generateByteOrderMark() const
Devuelve « true » si « QTextStream » está configurado para generar el BOM (Byte Order Mark) de UTF al utilizar una codificación UTF; en caso contrario, devuelve « false ». La generación del BOM de UTF está desactivada por defecto.
Véase también setGenerateByteOrderMark().
int QTextStream::integerBase() const
Devuelve la base actual de los números enteros. El valor 0 significa que la base se detecta al leer, o 10 (decimal) al generar números.
Véase también setIntegerBase(), QString::number() y numberFlags().
QLocale QTextStream::locale() const
Devuelve la configuración regional de este flujo. La configuración regional predeterminada es C.
Véase también setLocale().
QTextStream::NumberFlags QTextStream::numberFlags() const
Devuelve los indicadores numéricos actuales.
Véase también setNumberFlags(), integerBase() y realNumberNotation().
QChar QTextStream::padChar() const
Devuelve el carácter de relleno actual.
Véase también setPadChar() y setFieldWidth().
qint64 QTextStream::pos() const
Devuelve la posición del dispositivo correspondiente a la posición actual del flujo, o -1 si se produce un error (por ejemplo, si no hay ningún dispositivo o cadena, o si se produce un error en el dispositivo).
Dado que ` QTextStream ` está almacenado en búfer, es posible que esta función tenga que buscar en el dispositivo para reconstruir una posición válida del mismo. Esta operación puede resultar costosa, por lo que es recomendable evitar llamar a esta función en un bucle muy rápido.
Véase también seek().
QString QTextStream::read(qint64 maxlen)
Lee como máximo maxlen caracteres del flujo y devuelve los datos leídos como un objeto ` QString`.
Véase también readAll(), readLine() y QIODevice::read().
QString QTextStream::readAll()
Lee todo el contenido del flujo y lo devuelve como un objeto ` QString`. Evita utilizar esta función cuando trabajes con archivos de gran tamaño, ya que consumirá una cantidad significativa de memoria.
Es mejor llamar a ` readLine()` si no sabes cuántos datos hay disponibles.
Véase también readLine().
QString QTextStream::readLine(qint64 maxlen = 0)
Lee una línea de texto del flujo y la devuelve como un objeto ` QString`. La longitud máxima permitida para una línea se establece en ` maxlen`. Si el flujo contiene líneas más largas que esto, dichas líneas se dividirán tras ` maxlen ` caracteres y se devolverán por partes.
Si maxlen es 0, las líneas pueden tener cualquier longitud.
La línea devuelta no contiene caracteres de fin de línea al final («\n » o «\r\n »), por lo que puede que no sea necesario llamar a QString::trimmed().
Si el flujo ha llegado al final del archivo, readLine() devolverá un QString nulo. En el caso de las cadenas, o de los dispositivos que lo admitan, se puede comprobar explícitamente si se ha llegado al final del flujo utilizando atEnd().
Véanse también readAll() y QIODevice::readLine().
bool QTextStream::readLineInto(QString *line, qint64 maxlen = 0)
Lee una línea de texto del flujo y la almacena en ` line`. Si ` line ` es ` nullptr`, la línea leída no se almacena.
La longitud máxima permitida para una línea se establece en maxlen. Si el flujo contiene líneas más largas que esto, las líneas se dividirán tras maxlen caracteres y se devolverán por partes.
Si maxlen es 0, las líneas pueden tener cualquier longitud.
La línea resultante no tiene caracteres de fin de línea al final («\n » o «\r\n »), por lo que puede que no sea necesario llamar a QString::trimmed().
Si « line » tiene capacidad suficiente para los datos que se van a leer, es posible que esta función no necesite asignar nueva memoria. Por este motivo, puede resultar más rápida que « readLine()».
Devuelve ` false ` si el flujo ha llegado al final del archivo o se ha producido un error; en caso contrario, devuelve ` true`. El contenido de ` line ` anterior a la llamada se descarta en cualquier caso.
Véase también readAll(), QIODevice::readLine() y QIODevice::readLineInto().
QTextStream::RealNumberNotation QTextStream::realNumberNotation() const
Devuelve la notación actual de los números reales.
Véase también setRealNumberNotation(), realNumberPrecision(), numberFlags() y integerBase().
int QTextStream::realNumberPrecision() const
Devuelve la precisión actual de los números reales, es decir, el número de dígitos fraccionarios que escribirá QTextStream al generar números reales (FixedNotation, ScientificNotation), o el número máximo de dígitos significativos (SmartNotation).
Véanse también setRealNumberPrecision(), setRealNumberNotation(), realNumberNotation(), numberFlags() y integerBase().
void QTextStream::reset()
Restablece las opciones de formato de ` QTextStream`, devolviéndola a su estado original tras la construcción. El dispositivo, la cadena y cualquier dato almacenado en el búfer no se modifican.
void QTextStream::resetStatus()
Restablece el estado del flujo de texto.
Véanse también QTextStream::Status, status() y setStatus().
bool QTextStream::seek(qint64 pos)
Busca la posición pos en el dispositivo. Devuelve true si la operación se realiza correctamente; en caso contrario, devuelve false.
void QTextStream::setAutoDetectUnicode(bool enabled)
Si ` enabled ` es verdadero, ` QTextStream ` intentará detectar la codificación Unicode examinando los datos del flujo para ver si encuentra la marca de orden de bytes (BOM) de UTF-8, UTF-16 o UTF-32. Si se encuentra esta marca, ` QTextStream ` sustituirá la codificación actual por la codificación UTF.
Esta función se puede utilizar junto con setEncoding(). Es habitual establecer la codificación en UTF-8 y, a continuación, habilitar la detección de UTF-16.
Véanse también autoDetectUnicode() y setEncoding().
void QTextStream::setDevice(QIODevice *device)
Establece el dispositivo actual en device. Si ya se ha asignado un dispositivo, QTextStream llamará a flush() antes de sustituir el dispositivo anterior.
Nota: Esta función restablece la configuración regional a la predeterminada («C») y la codificación a la predeterminada, UTF-8.
Véanse también device() y setString().
[since 6.0] void QTextStream::setEncoding(QStringConverter::Encoding encoding)
Establece la codificación de este flujo en « encoding ». La codificación se utiliza para decodificar cualquier dato que se lea del dispositivo asignado y para codificar cualquier dato que se escriba. Por defecto, se utiliza « QStringConverter::Utf8 » y la detección automática de Unicode está activada.
Si QTextStream actúa sobre una cadena, esta función no realiza ninguna acción.
Advertencia: Si se invoca esta función mientras el flujo de texto está leyendo desde un socket secuencial abierto, es posible que el búfer interno siga conteniendo texto decodificado con la codificación anterior.
Esta función se introdujo en Qt 6.0.
Véase también encoding(), setAutoDetectUnicode() y setLocale().
void QTextStream::setFieldAlignment(QTextStream::FieldAlignment mode)
Establece la alineación del campo en « mode ». Cuando se utiliza junto con « setFieldWidth()», esta función permite generar una salida formateada con el texto alineado a la izquierda, a la derecha o al centro.
Véanse también fieldAlignment() y setFieldWidth().
void QTextStream::setFieldWidth(int width)
Establece el ancho de campo actual en ` width`. Si ` width ` es 0 (valor por defecto), el ancho de campo es igual a la longitud del texto generado.
Nota: El ancho de campo se aplica a todos los elementos añadidos a este flujo tras la llamada a esta función (por ejemplo, también rellena «endl»). Este comportamiento difiere del de clases similares de la STL, en las que el ancho de campo solo se aplica al siguiente elemento.
Véanse también fieldWidth() y setPadChar().
void QTextStream::setGenerateByteOrderMark(bool generate)
Si generate es verdadero y se utiliza una codificación UTF, QTextStream insertará la marca de orden de bytes (BOM) antes de que se haya escrito ningún dato en el dispositivo. Si generate es falso, no se insertará ninguna BOM. Esta función debe llamarse antes de escribir cualquier dato. De lo contrario, no realiza ninguna acción.
Véase también generateByteOrderMark() y bom().
void QTextStream::setIntegerBase(int base)
Establece la base de los números enteros en « base », tanto para la lectura como para la generación de números. « base » puede ser 2 (binario), 8 (octal), 10 (decimal) o 16 (hexadecimal). Si ` base ` es 0, ` QTextStream ` intentará detectar la base analizando los datos del flujo. Al generar números, ` QTextStream ` asume que la base es 10, a menos que se haya establecido explícitamente.
Véanse también integerBase(), QString::number() y setNumberFlags().
void QTextStream::setLocale(const QLocale &locale)
Establece la configuración regional de este flujo en locale. La configuración regional especificada se utiliza para las conversiones entre números y sus representaciones como cadenas.
La configuración regional predeterminada es C y constituye un caso especial: no se utiliza el separador de miles por motivos de compatibilidad con versiones anteriores.
Véase también locale().
void QTextStream::setNumberFlags(QTextStream::NumberFlags flags)
Establece los indicadores numéricos actuales en flags. flags es un conjunto de indicadores de la enumeración NumberFlag, y describe las opciones para dar formato al código generado (por ejemplo, si se debe escribir siempre la base o el signo de un número).
Véanse también numberFlags(), setIntegerBase() y setRealNumberNotation().
void QTextStream::setPadChar(QChar ch)
Establece el carácter de relleno en « ch ». El valor por defecto es el carácter de espacio ASCII (« ' ' ») o « QChar » (0x20). Este carácter se utiliza para rellenar los espacios en los campos al generar texto.
Ejemplo:
QString s;
QTextStream out(&s);
out.setFieldWidth(10);
out.setFieldAlignment(QTextStream::AlignCenter);
out.setPadChar('-');
out << "Qt" << "rocks!";La cadena s contiene:
----Qt------rocks!--Véase también padChar() y setFieldWidth().
void QTextStream::setRealNumberNotation(QTextStream::RealNumberNotation notation)
Establece la notación de los números reales en notation (SmartNotation, FixedNotation, ScientificNotation). Al leer y generar números, QTextStream utiliza este valor para detectar el formato de los números reales.
Véase también realNumberNotation(), setRealNumberPrecision(), setNumberFlags() y setIntegerBase().
void QTextStream::setRealNumberPrecision(int precision)
Establece la precisión de los números reales en precision. Este valor describe el número de dígitos fraccionarios que QTextStream debe escribir al generar números reales (FixedNotation, ScientificNotation), o el número máximo de dígitos significativos (SmartNotation).
La precisión no puede ser un valor negativo. El valor por defecto es 6.
Véase también realNumberPrecision() y setRealNumberNotation().
void QTextStream::setStatus(QTextStream::Status status)
Establece el estado del flujo de texto en el valor de « status » especificado.
Las llamadas posteriores a setStatus() se ignoran hasta que se llame a resetStatus().
Véase también Status, status() y resetStatus().
void QTextStream::setString(QString *string, QIODeviceBase::OpenMode openMode = ReadWrite)
Establece la cadena actual en « string », utilizando el « openMode » indicado. Si ya se ha asignado un dispositivo, « QTextStream » llamará a « flush()» antes de sustituirlo.
Véanse también string() y setDevice().
void QTextStream::skipWhiteSpace()
Lee y descarta los espacios en blanco del flujo hasta que se detecte un carácter que no sea un espacio, o hasta que la función ` atEnd()` devuelva «true». Esta función resulta útil a la hora de leer un flujo carácter por carácter.
Los caracteres de espacio en blanco son todos aquellos para los que QChar::isSpace() devuelve true.
Véase también ` operator>>()`.
QTextStream::Status QTextStream::status() const
Devuelve el estado del flujo de texto.
Véase también QTextStream::Status, setStatus() y resetStatus().
QString *QTextStream::string() const
Devuelve la cadena actual asignada a ` QTextStream`, o ` nullptr ` si no se ha asignado ninguna cadena.
Véase también setString() y device().
[explicit noexcept, since 6.10] QTextStream::operator bool() const
Devuelve si este flujo no presenta errores (la función `status()` devuelve ` Ok`).
Esta función se introdujo en Qt 6.10.
QTextStream &QTextStream::operator<<(QChar c)
Escribe el carácter « c » en el flujo y, a continuación, devuelve una referencia a « QTextStream ».
Véase también setFieldWidth().
QTextStream &QTextStream::operator<<(const QString &string)
Escribe la cadena « string » en el flujo y devuelve una referencia a « QTextStream ». La cadena se codifica primero utilizando la codificación asignada (la predeterminada es UTF-8) antes de escribirse en el flujo.
Véase también setFieldWidth() y setEncoding().
QTextStream &QTextStream::operator<<(float f)
Escribe el número real f en el flujo y, a continuación, devuelve una referencia a QTextStream. De forma predeterminada, QTextStream lo almacena utilizando SmartNotation, con una precisión de hasta 6 dígitos. Puedes cambiar la representación textual que utilizará QTextStream para los números reales llamando a setRealNumberNotation(), setRealNumberPrecision() y setNumberFlags().
Véase también setFieldWidth(), setRealNumberNotation(), setRealNumberPrecision() y setNumberFlags().
QTextStream &QTextStream::operator<<(short i)
Escribe el número entero i en el flujo y, a continuación, devuelve una referencia a QTextStream. Por defecto, el número se almacena en formato decimal, pero también se puede establecer la base llamando a setIntegerBase().
Véase también setFieldWidth() y setNumberFlags().
QTextStream &QTextStream::operator<<(QLatin1StringView string)
Escribe ` string ` en el flujo y devuelve una referencia a ` QTextStream`.
Se trata de una función sobrecargada.
QTextStream &QTextStream::operator<<(QStringView string)
Escribe ` string ` en el flujo y devuelve una referencia a ` QTextStream`.
Se trata de una función sobrecargada.
QTextStream &QTextStream::operator<<(char c)
Convierte ` c ` de ASCII a ` QChar` y, a continuación, lo escribe en el flujo.
Esta es una función sobrecargada.
[since 6.3.1] QTextStream &QTextStream::operator<<(char16_t c)
Escribe el carácter Unicode c en el flujo y, a continuación, devuelve una referencia a QTextStream.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.3.1.
QTextStream &QTextStream::operator<<(const QByteArray &array)
Escribe « array » en el flujo. El contenido de « array » se convierte con « QString::fromUtf8()».
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(const char *string)
Escribe en el flujo la cadena constante a la que apunta string. Se supone que string está codificada en UTF-8. Este operador resulta útil cuando se trabaja con datos de cadenas constantes. Ejemplo:
QTextStream out(stdout);
out << "Qt rocks!" << Qt::endl;Advertencia: QTextStream da por hecho que string apunta a una cadena de texto que termina con un carácter «'\0'». Si no hay un carácter de terminación «'\0'», tu aplicación podría bloquearse.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(const void *ptr)
Escribe « ptr » en el flujo como un número hexadecimal con una base.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(double f)
Escribe el valor de tipo «double f » en el flujo.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(int i)
Escribe el entero con signo i en el flujo.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(long i)
Escribe el valor « i » de tipo «long» con signo en el flujo.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(qlonglong i)
Escribe el valor qlonglong « i » en el flujo.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(qulonglong i)
Escribe el « i » de tipo qulonglong en el flujo.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(unsigned int i)
Escribe el valor de tipo `unsigned int` i en el flujo.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(unsigned long i)
Escribe el valor « i » (tipo unsigned long) en el flujo.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator<<(unsigned short i)
Escribe el valor « i » (tipo unsigned short) en el flujo.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator>>(QChar &c)
Lee un carácter del flujo y lo almacena en ` c`. Devuelve una referencia a ` QTextStream`, por lo que se pueden anidar varios operadores. Ejemplo:
QTextStream in(file);
QChar ch1, ch2, ch3;
in >> ch1 >> ch2 >> ch3;No se omiten los espacios en blanco.
QTextStream &QTextStream::operator>>(QString &str)
Lee una palabra del flujo y la almacena en ` str`, y a continuación devuelve una referencia al flujo. Las palabras están separadas por espacios en blanco (es decir, todos los caracteres para los que ` QChar::isSpace()` devuelve ` true`).
Se omiten los espacios en blanco iniciales.
QTextStream &QTextStream::operator>>(float &f)
Lee un número real del flujo y lo almacena en ` f`, tras lo cual devuelve una referencia a ` QTextStream`. El número se convierte al tipo correcto. Si no se detecta ningún número real en el flujo, ` f ` se establece en 0,0.
Como excepción especial, QTextStream permite que las cadenas «nan» e «inf» representen valores flotantes o de doble precisión NAN e INF.
Se omiten los espacios en blanco iniciales.
QTextStream &QTextStream::operator>>(short &i)
Lee un número entero del flujo y lo almacena en ` i`, tras lo cual devuelve una referencia a ` QTextStream`. El número se convierte al tipo correcto antes de almacenarlo. Si no se ha detectado ningún número en el flujo, ` i ` se establece en 0.
Por defecto, ` QTextStream ` intentará detectar la base del número utilizando las siguientes reglas:
| Prefijo | Base |
|---|---|
| «0b» o «0B» | 2 (binario) |
| «0» seguido de «0-7» | 8 (octal) |
| «0» en los demás casos | 10 (decimal) |
| «0x» o «0X» | 16 (hexadecimal) |
| «1» a «9» | 10 (decimal) |
Al llamar a ` setIntegerBase()`, puedes especificar la base del número entero de forma explícita. Esto desactivará la detección automática y acelerará ligeramente ` QTextStream `.
Se omiten los espacios en blanco iniciales.
QTextStream &QTextStream::operator>>(QByteArray &array)
Convierte la palabra a UTF-8 y, a continuación, la almacena en ` array`.
Esta es una función sobrecargada.
Véase también QString::toLatin1().
QTextStream &QTextStream::operator>>(char &c)
Lee un carácter del flujo y lo almacena en ` c`. El carácter del flujo se convierte a ISO-8859-1 antes de almacenarlo.
Esta es una función sobrecargada.
Véase también QChar::toLatin1().
[since 6.4] QTextStream &QTextStream::operator>>(char16_t &c)
Lee un carácter del flujo y lo almacena en ` c`.
Esta es una función sobrecargada.
Esta función se introdujo en Qt 6.4.
QTextStream &QTextStream::operator>>(double &f)
Almacena el número real en la variable de tipo double « f ».
Se trata de una función sobrecargada.
QTextStream &QTextStream::operator>>(int &i)
Almacena el número entero en el tipo «signed int» i.
Se trata de una función sobrecargada.
QTextStream &QTextStream::operator>>(long &i)
Almacena el número entero en el tipo «long con signo» i.
Se trata de una función sobrecargada.
QTextStream &QTextStream::operator>>(qlonglong &i)
Almacena el número entero en el tipo qlonglong « i ».
Esta es una función sobrecargada.
QTextStream &QTextStream::operator>>(qulonglong &i)
Almacena el número entero en el tipo « i » de tipo qulonglong.
Esta es una función sobrecargada.
QTextStream &QTextStream::operator>>(unsigned int &i)
Almacena el número entero en la variable ` i` de tipo `unsigned int`.
Se trata de una función sobrecargada.
QTextStream &QTextStream::operator>>(unsigned long &i)
Almacena el número entero en el tipo «unsigned long» i.
Se trata de una función sobrecargada.
QTextStream &QTextStream::operator>>(unsigned short &i)
Almacena el número entero en el tipo «unsigned short» i.
Se trata de una función sobrecargada.
Elementos no miembros relacionados
QTextStreamManipulator qSetFieldWidth(int width)
Equivalente a « QTextStream::setFieldWidth » (width).
QTextStreamManipulator qSetPadChar(QChar ch)
Equivalente a QTextStream::setPadChar(ch).
QTextStreamManipulator qSetRealNumberPrecision(int precision)
Equivalente a « QTextStream::setRealNumberPrecision » (precision).
© 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.