QTextStream

友善啊，朋友

已于 2022-07-14 10:06:43 修改

阅读量5.7k

点赞数 4

分类专栏： Qt Core模块文章标签： qt

于 2022-07-13 23:12:38 首次发布

本文链接：https://blog.csdn.net/kenfan1647/article/details/125610836

版权

Qt Core模块专栏收录该内容

34 篇文章 47 订阅

订阅专栏

一、描述

QTextStream 类为读写文本提供了一个方便的接口。

QTextStream 可以对 QIODevice、QByteArray 或 QString 进行操作。使用 QTextStream 的流式操作符，可以方便地读写单词、行和数字。对于生成文本，QTextStream 支持字段填充和对齐的格式选项，以及数字的格式。

默认情况下，使用 UTF-8 编码读写，也可以通过调用 setEncoding() 来设置编码。

默认情况下，当从文本流中读取数字时，QTextStream 会自动检测数字的基本表示。例如，如果数字以“0x”开头，则假定为十六进制形式。如果它以数字 1-9 开头，则假定为十进制形式，依此类推。可以通过调用 setIntegerBase() 设置整数基数，从而禁用自动检测。

与标准 C++ 库中的 <iostream> 一样，QTextStream 也定义了一些全局操作符函数：

Qt::bin：与 setIntegerBase(2) 相同。
Qt::oct：与 setIntegerBase(8) 相同。
Qt::dec：与 setIntegerBase(10) 相同。
Qt::hex：与 setIntegerBase(16) 相同。
Qt::showbase：与 setNumberFlags(numberFlags() | ShowBase) 相同。
Qt::forcesign：与 setNumberFlags(numberFlags() | ForceSign) 相同。
Qt::forcepoint：与 setNumberFlags(numberFlags() | ForcePoint) 相同。
Qt::noshowbase：与 setNumberFlags(numberFlags() & ~ShowBase) 相同。
Qt::noforcesign：与 setNumberFlags(numberFlags() & ~ForceSign) 相同。
Qt::noforcepoint：与 setNumberFlags(numberFlags() & ~ForcePoint) 相同。
Qt::uppercasebase：与 setNumberFlags(numberFlags() | UppercaseBase) 相同。
Qt::uppercasedigits：与 setNumberFlags(numberFlags() | UppercaseDigits) 相同。
Qt::lowercasebase：与 setNumberFlags(numberFlags() & ~UppercaseBase) 相同。
Qt::lowercasedigits：与 setNumberFlags(numberFlags() & ~UppercaseDigits) 相同。
Qt::fixed：与 setRealNumberNotation(FixedNotation) 相同。
Qt::scientific：与 setRealNumberNotation(ScientificNotation) 相同。
Qt::left：与 setFieldAlignment(AlignLeft) 相同。
Qt::right：与 setFieldAlignment(AlignRight) 相同。
Qt::center：与 setFieldAlignment(AlignCenter) 相同。
Qt::endl：与 operator<<('\n') 和 flush() 相同。
Qt::flush：与 flush() 相同。
Qt::reset：与 reset() 相同。
Qt::ws：与 skipWhiteSpace() 相同。
Qt::bom：与 setGenerateByteOrderMark(true) 相同。

二、类型成员

1、enum QTextStream::FieldAlignment：此枚举指定当字段比占据它的文本更宽时如何对齐字段中的文本。

AlignLeft：填充在字段的右侧。
AlignRight：填充在字段的左侧。
AlignCenter：填充在字段的两侧。
AlignAccountingStyle：与 AlignRight 相同，只是数字的符号向左对齐。

2、enum QTextStream::NumberFlag：此枚举指定可以设置以影响整数、浮点数和双精度数的输出的各种标志。

ShowBase：如果基数是 16 ("0x")、8 ("0") 或 2 ("0b")，则将基数显示为前缀。
ForcePoint：始终将小数分隔符放在数字中，即使没有小数。
ForceSign：始终将符号放入数字中，即使是正数。
UppercaseBase：使用大写版本的基本前缀（“0X”、“0B”）。
UppercaseDigits ：使用大写字母表示数字 10 到 35。

3、enum QTextStream::RealNumberNotation：此枚举指定用于将浮点数和双精度数表示为字符串的符号。

ScientificNotation：科学记数法（printf() 的 %e 标志）。
FixedNotation：定点符号（printf() 的 %f 标志）。
SmartNotation：科学或定点符号，取决于哪个最有意义（printf() 的 %g 标志）。

4、enum QTextStream::Status：此枚举描述了文本流的当前状态。

Ok：运行正常。
ReadPastEnd：已读到底层设备中数据的末尾。
ReadCorruptData：已读取损坏的数据。
WriteFailed：无法写入底层设备。

三、成员函数

1、QTextStream(const QByteArray &array, QIODeviceBase::OpenMode openMode = ReadOnly)

QTextStream(QByteArray *array, QIODeviceBase::OpenMode openMode = ReadWrite)

QTextStream(QString *string, QIODeviceBase::OpenMode openMode = ReadWrite)

QTextStream(FILE *fileHandle, QIODeviceBase::OpenMode openMode = ReadWrite)

QTextStream(QIODevice *device)

构造一个对参数1 进行操作的 QTextStream，使用 openMode 来定义打开模式。

    QByteArray ba;
    QTextStream in(&ba,QIODeviceBase::WriteOnly);

    for (int i = 0; i < 10; ++i)
    {
        in << i;
    }
    in.flush();

2、bool atEnd()

是否没有更多数据要从 QTextStream 读取。

3、bool autoDetectUnicode()

是否启用了自动 Unicode 检测，默认启用。

4、QIODevice * device()

返回关联的当前设备。

5、QStringConverter::Encoding encoding()

当前分配给流的编码。

enum QStringConverter::Encoding：

Utf8
Utf16
Utf16BE
Utf16LE
Utf32
Utf32BE
Utf32LE
Latin1
System

6、QTextStream::FieldAlignment fieldAlignment()

当前字段对齐方式。

7、int fieldWidth() / void setFieldWidth(int width)

字段宽度。如果宽度为 0（默认值），则字段宽度等于生成文本的长度。

字段宽度适用于在调用此函数后附加到此流的每个元素。

8、void flush()

刷新任何等待写入设备的缓冲数据。

如果 QTextStream 是对字符串进行操作，则此函数不执行任何操作。

9、bool generateByteOrderMark()

是否设置为在使用 UTF 编码时生成 UTF BOM（字节顺序标记）。默认为 false。

10、void setIntegerBase(int base) / int integerBase()

设置整数的基数。基数用于读取和生成数字。

基数可以是 2（二进制）、8（八进制）、10（十进制）或 16（十六进制）。

如果 base 为 0，QTextStream 将尝试通过检查流上的数据来检测 base。生成数字时，QTextStream 默认假定基数为 10。

11、QLocale locale()

语言环境。

12、QTextStream::NumberFlags numberFlags()

当前数字标志。

13、QChar padChar() / void setPadChar(QChar ch)

填充字符。默认值为 ASCII 空格字符 (' ') 或 QChar(0x20)。

该字符用于在生成文本时填充字段中的空格。

14、qint64 pos()

返回与流的当前位置对应的设备位置，如果发生错误（没有设备或字符串，或者有设备错误），则返回 -1。

此操作可能很昂贵，因此应该避免在循环中调用此函数。

15、QString read(qint64 maxlen)

从流中读取最多 maxlen 个字符，并将读取的数据作为 QString 返回。

16、QString readAll()

读取流的全部内容，并将其作为 QString 返回。在处理大文件时避免使用此功能，因为它会消耗大量内存。

如果不知道有多少数据可用，则调用 readLine() 会更好。

17、QString readLine(qint64 maxlen = 0)

从流中读取一行文本，并将其作为 QString 返回。

允许的最大行长度设置为 maxlen。如果流包含比这更长的行，则这些行将在 maxlen 个字符之后拆分并部分返回。

如果 maxlen 为 0，则行可以是任意长度。

返回的行没有尾随的行尾字符（“\n”或“\r\n”），因此可能不需要调用 QString::trimmed()。

如果流已读到文件末尾，readLine() 将返回一个空 QString。对于字符串或支持它的设备，可以使用 atEnd() 显式测试流的结尾。

18、bool readLineInto(QString *line, qint64 maxlen = 0)

从流中读取一行文本到 line 中。如果 line 为 nullptr，则不存储读取的行。

允许的最大行长度设置为 maxlen。如果流包含比这更长的行，则这些行将在 maxlen 个字符之后拆分并部分返回。

如果 maxlen 为 0，则行可以是任意长度。

结果行没有尾随的行尾字符（“\n”或“\r\n”），因此可能不需要调用 QString::trimmed()。

如果 line 有足够的容量容纳即将被读取的数据，这个函数可能不需要分配新的内存。因此，它可以比 readLine() 更快。

如果流已读取到文件末尾或发生错误，则返回 false，否则返回 true。在任何情况下，调用前 line 的内容都会被丢弃。

19、void reset()

重置 QTextStream 的格式化选项，使其恢复到原来的构造状态。设备、字符串和任何缓冲数据保持不变。

20、void resetStatus()

重置文本流的状态。

21、bool seek(qint64 pos)

寻找设备中的位置 pos。返回是否查询成功。

22、void setAutoDetectUnicode(bool enabled)

如果 enabled 为 true，QTextStream 将尝试通过查看流数据来检测 Unicode 编码，以查看它是否可以找到 UTF-8、UTF-16 或 UTF-32 字节顺序标记 (BOM)。如果找到这个标记，QTextStream 会将当前编码替换为 UTF 编码。

该函数可以与 setEncoding() 一起使用。通常将编码设置为 UTF-8，然后启用 UTF-16 检测。

23、void setGenerateByteOrderMark(bool generate)

如果 generate 为 true 并且使用了 UTF 编码，QTextStream 将在任何数据写入设备之前插入 BOM（字节顺序标记）。必须在写入任何数据之前调用此函数。

24、void setRealNumberPrecision(int precision)

设置在生成实数时应该写入的小数位数的精度。精度不能为负值。默认为 6。

25、void setString(QString *string, QIODeviceBase::OpenMode openMode = ReadWrite)

QString * string()

使用 openMode 设置字符串。如果 QTextStream 已经被分配了一个设备，则将在替换之前调用flush()。

26、void skipWhiteSpace()

从流中读取并丢弃空白字符，直到检测到非空格字符，或者直到 atEnd() 返回 true。此函数在逐字符读取流时很有用。

空白字符是 QChar::isSpace() 返回 true 的所有字符。

    QString ba;
    QTextStream in(&ba,QIODeviceBase::ReadWrite);
    in << ' ';

    for (int i = 1; i < 10; ++i)
    {
        in << i;
        in << ' ';
    }
    in.flush();

    qDebug()<<ba.size()<<" sc "<<ba;
    in.skipWhiteSpace();
    qDebug()<<in.readLine();
    qDebug()<<ba.size()<<" sc "<<ba;

27、operator>>

QTextStream & operator>>(QChar &c)

QTextStream & operator>>(char &c)

从流中读取一个字符并将其存储在 c 中。

返回对 QTextStream 的引用，因此可以嵌套多个运算符。不跳过空格。

QTextStream in(file);
QChar ch1, ch2, ch3;
in >> ch1 >> ch2 >> ch3;

QTextStream & operator>>(short &i)

... 多个整数类型参数的重载 ...

从流中读取一个整数并将其存储在 i 中，然后返回对 QTextStream 的引用。数字在存储之前被转换为正确的类型。如果在流中未检测到数字，则将 i 设置为 0。

默认情况下，QTextStream 将尝试使用以下规则检测数字的基数：

“0b”或“0B”：二进制
“0”后跟“0-7”：八进制
"0"：十进制
“0x”或“0X”：十六进制
“1”到“9”：十进制

QTextStream & operator>>(float &f)

QTextStream & operator>>(double &f)

从流中读取一个实数并将其存储在 f 中，然后返回对 QTextStream 的引用。该数字被转换为正确的类型。如果在流上没有检测到实数，则 f 设置为 0.0。

作为一个特殊的例外，QTextStream 允许字符串“nan”和“inf”表示 NAN 和 INF 浮点数或双精度数。

QTextStream & operator>>(QString &str)