12-Qt QFile文件操作详解

很多应用程序都需要具备操作文件的能力，包括对文件内容进行读/写、创建和删除文件等，甚至某些应用程序的诞生纯粹是为了操作文件，比如 WPS Office、PDFedit 等。为此，Qt 框架提供了 QFile 类专门用来操作文件。

QFile文件操作

QFile 类支持对文件进行读取、写入、删除、重命名、拷贝等操作，它既可以操作文件文件，也可以操作二进制文件。

使用 QFile 类操作文件之前，程序中需引入<QFile>头文件。创建 QFile 类的对象，常用的构造函数有：

QFile::QFile()
QFile::QFile(const QString &name)

参数 name 用来指定要操作的目标文件，包含文件的存储路径和文件名，存储路径可以使用绝对路径（比如 "D:/Demo/test.txt"）或者相对路径（比如"./Demo/test.txt"），路径中的分隔符要用 "/" 表示。

通常情况下，我们会调用第二个构造函数，直接指明要操作的文件。对于第一个构造函数创建的 QFile 对象，需要再调用 setFileName() 方法指明要操作的文件。

与 C++ 读写文件的规则一样，使用 QFile 读写文件之前必须先打开文件，调用 open() 成员方法即可，常用的语法格式为：

bool QFile::open(OpenMode mode)

mode 参数用来指定文件的打开方式，下表罗列了此参数的可选值以及各自的含义：
 

表 1 QFile文件打开方式

打开方式	含 义
QIODevice::ReadOnly	只能对文件进行读操作
QIODevice::WriteOnly	只能对文件进行写操作，如果目标文件不存在，会自行创建一个新文件。
QIODevice::ReadWrite	等价于 ReadOnly | WriteOnly，能对文件进行读和写操作。
QIODevice::Append	以追加模式打开文件，写入的数据会追加到文件的末尾（文件原有的内容保留）。
QIODevice::Truncate	以重写模式打开，写入的数据会将原有数据全部清除。注意，此打开方式不能单独使用，通常会和 ReadOnly 或 WriteOnly 搭配。
QIODevice::Text	读取文件时，会将行尾结束符（Unix 系统中是 "\n"，Windows 系统中是 "\r\n"）转换成‘\n’；将数据写入文件时，会将行尾结束符转换成本地格式，例如 Win32 平台上是‘\r\n’。

根据需要，可以为 mode 参数一次性指定多个值，值和值之间用|分割。比如：

• QIODevice::ReadOnly | QIODevice::Text：表示只允许对文件进行读操作，读取文件时，会将行尾结束符转换为 '\n'；
• QIODevice::WriteOnly | QIODevice::Text：表示只允许对文件进行写操作，将数据写入文件时，会将行尾结束符转换为本地格式；
• QIODevice::ReadWrite | QIODevice::Append | QIODevice::Text：表示对文件进行写操作，写入的数据会存放到文件的尾部，同时数据中的行尾结束符转换为本地格式。

注意，传递给 mode 参数的多个值之间不能相互冲突，比如 Append 和 Truncate 不能同时使用。

如果文件成功打开，open() 函数返回 true，否则返回 false。

QFile 类提供了很多功能实用的方法，可以快速完成对文件的操作，下表列举了常用的一些：
 

表 2 QFile常用方法

普通成员方法	功 能
qint64 QFile::size() const	获取当前文件的大小。对于打开的文件，该方法返回文件中可以读取的字节数。
bool QIODevice::getChar(char *c)	从文件中读取一个字符，并存储到 c 中。读取成功时，方法返回 true，否则返回 false。
bool QIODevice::putChar(char c)	向文件中写入字符 c，成功时返回 true，否则返回 false。
QByteArray QIODevice::read(qint64 maxSize)	从文件中一次性最多读取 maxSize 个字节，然后返回读取到的字节。
qint64 QIODevice::read(char *data, qint64 maxSize)	从文件中一次性对多读取 max