QT QFile「建议收藏」

大家好，又见面了，我是你们的朋友全栈君。

QFile类提供了读取和写入文件的接口。

QFile是一个读写文本和二进制文件和资源的I/O设备。QFile可以单独使用，或者更方便地与QTextStream或QDataStream一起使用。

文件名通常在构造函数中传递，但它可以在任何时候使用setFileName()设置。无论操作系统如何，QFile都希望文件分隔符为“/”。不支持使用其他分隔符(例如’\’)。

您可以使用exists()检查文件是否存在，并使用remove()删除文件。(更高级的文件系统相关操作由QFileInfo和QDir提供。)

文件用open()打开，用close()关闭，用flush()刷新。数据通常使用QDataStream或QTextStream进行读写，但您也可以调用qiodevice继承的函数read()、readLine()、readAll()和write()。QFile还继承了getChar()、putChar()和ungetChar()，它们一次工作一个字符。

文件的大小由size()返回。您可以使用pos()获取当前的文件位置，或者使用seek()移动到一个新的文件位置。如果到达了文件的末尾，atEnd()返回true。

直接读取文件

下面的示例逐行读取文本文件:

    QFile file("in.txt");
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text))
        return;

    while (!file.atEnd()) {
        QByteArray line = file.readLine();
        process_line(line);
    }

传递给open()的QIODevice::Text标志告诉Qt将windows风格的行终止符(“\r\n”)转换为c++风格的终止符(“\n”)。默认情况下，QFile采用二进制格式，也就是说，它不会对存储在文件中的字节执行任何转换。

使用流读取文件

下一个例子使用QTextStream逐行读取文本文件:

    QFile file("in.txt");
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text))
        return;

    QTextStream in(&file);
    while (!in.atEnd()) {
        QString line = in.readLine();
        process_line(line);
    }

QTextStream负责将存储在磁盘上的8位数据转换为16位Unicode QString。默认情况下，它假定使用用户系统的本地8位编码(例如，在大多数基于unix的操作系统上，UTF-8;详见QTextCodec::codecForLocale())。这可以通过QTextStream::setCodec()来改变。

要写文本，我们可以使用operator<<()，它重载了左边的QTextStream和右边的各种数据类型(包括QString):

    QFile file("out.txt");
    if (!file.open(QIODevice::WriteOnly | QIODevice::Text))
        return;

    QTextStream out(&file);
    out << "The magic number is: " << 49 << "\n";

QDataStream与此类似，可以使用操作符<<()写入数据，使用操作符>>()读取数据。详细信息请参见类文档。

当您使用QFile、QFileInfo和QDir访问使用Qt的文件系统时，您可以使用Unicode文件名。在Unix上，这些文件名被转换为8位编码。如果你想使用标准c++ api (<cstdio>或<iostream>)或特定于平台的api来访问文件而不是QFile，你可以使用encodeName()和decodeName()函数来在Unicode文件名和8位文件名之间进行转换。

在Unix上，有一些特殊的系统文件(例如在/proc中)，size()总是返回0，但是你仍然可以从这样的文件中读取更多的数据;生成数据是对调用read()的直接响应。然而，在这种情况下，您不能使用atEnd()来确定是否有更多的数据需要读取(因为atEnd()对于声明大小为0的文件将返回true)。相反，您应该调用readAll()，或反复调用read()或readLine()，直到无法读取更多的数据。下一个例子使用QTextStream逐行读取/proc/modules:

    QFile file("/proc/modules");
    if (!file.open(QIODevice::ReadOnly | QIODevice::Text))
        return;

    QTextStream in(&file);
    QString line = in.readLine();
    while (!line.isNull()) {
        process_line(line);
        line = in.readLine();
    }

信号

与其他QIODevice实现(如QTcpSocket)不同，QFile不发出aboutToClose()、bytesWritten()或readyRead()信号。这个实现细节意味着QFile不适合读写某些类型的文件，比如Unix平台上的设备文件。

特定于平台的问题

在Linux/Mac OS X和Windows上，文件权限的处理是不同的。在Linux下，非可写目录下无法创建文件。这在Windows上并不总是如此，例如，“My Documents”目录通常是不可写的，但仍然可以在其中创建文件。

Qt对文件权限的理解是有限的，这尤其影响QFile::setPermissions()函数。在Windows上，Qt只会设置旧的只读标志，并且只有当没有Write*标志被传递时才会设置。Qt不操作访问控制列表(acl)，这使得该函数对NTFS卷几乎毫无用处。它可能仍然对使用VFAT文件系统的USB驱动器有用。POSIX acl也不被操作。

请参见QTextStream、QDataStream、QFileInfo、QDir和Qt资源系统。