Qt QFile文件操作详解

很多应用程序都需要具备操作文件的能力，包括对文件内容进行读/写、创建和删除文件等，甚至某些应用程序的诞生纯粹是为了操作文件，比如 WPS Office、PDFedit 等。为此，Qt 框架提供了 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 参数用来指定文件的打开方式，下表罗列了此参数的可选值以及各自的含义：
 

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

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

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

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

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

【实例一】演示了 QFile 类读写文本文件的过程。

1. #include
2. #include
3. int main(int argc, char *argv[])
4. {
5. //创建 QFile 对象，同时指定要操作的文件
6. QFile file("D:/demo.txt");
7. //对文件进行写操作
8. if(!file.open(QIODevice::WriteOnly|QIODevice::Text)){
9. qDebug()<<"文件打开失败";
10. }
11. //向文件中写入两行字符串
12. file.write("C语言中文网\n");
13. file.write("http://c.biancheng.net");
14. //关闭文件
15. file.close();
17. //重新打开文件，对文件进行读操作
18. if(!file.open(QIODevice::ReadOnly|QIODevice::Text)){
19. qDebug()<<"文件打开失败";
20. }
21. //每次都去文件中的一行，然后输出读取到的字符串
22. char * str = new char[100];
23. qint64 readNum = file.readLine(str,100);
24. //当读取出现错误（返回 -1）或者读取到的字符数为 0 时，结束读取
25. while((readNum !=0) && (readNum != -1)){
26. qDebug() << str;
27. readNum = file.readLine(str,100);
28. }
29. file.close();
30. return 0;
31. }

执行程序，"C语言中文网" 和 "http://c.biancheng.net" 先写入 D 盘的 demo.txt 文件，然后再从文件中将它们读取出来。

【实例二】演示 QFile 读写二进制文件的过程。

1. #include
2. #include
3. int main(int argc, char *argv[])
4. {
5. //指定要写入文件的数据
6. qint32 nums[5]={1,2,3,4,5};
7. //写入文件之前，要将数据以二进制方式存储到字节数组中
8. QByteArray byteArr;
9. byteArr.resize(sizeof(nums));
10. for(int i=0;i<5;i++){
11. //借助指针，将每个整数拷贝到字节数组中
12. memcpy(byteArr.data()+i*sizeof(qint32),&(nums[i]),sizeof(qint32));
13. }
14. //将 byteArr 字节数组存储到文件中
15. QFile file("D:/demo.dat");
16. file.open(QIODevice::WriteOnly);
17. file.write(byteArr);
18. file.close();
20. //再次打开文件，读取文件中存储的二进制数据
21. file.open(QIODevice::ReadOnly);
22. QByteArray resArr = file.readAll();
23. //输出读取到的二进制数据
24. qDebug()<<"resArr: "<
25. //将二进制数据转化为整数
26. char* data = resArr.data();
27. while(*data){
28. qDebug() << *(qint32*)data;
29. data += sizeof(qint32);
30. }
31. return 0;
32. }

执行程序，demo.dat 文件中会存储 {1,2,3,4,5} 这 5 个整数的二进制形式，同时输出以下内容：

resArr:  "\x01\x00\x00\x00\x02\x00\x00\x00\x03\x00\x00\x00\x04\x00\x00\x00\x05\x00\x00\x00"
1
2
3
4
5

单独使用 QFile 类读写文件的过程既繁琐又复杂，Qt 提供了两个辅助类 QTextStream 和 QDataStream，前者用来读写文件文件，后者用来读写二进制文件，QFile 可以和它们搭配使用，从整体上提高读写文件的开发效率。

QFile+QTextStream

和单独使用 QFile 类读写文本文件相比，QTextStream 类提供了很多读写文件相关的方法，还可以设定写入到文件中的数据格式，比如对齐方式、写入数字是否带前缀等等。

使用 QTextStream 类之前，程序中要先引入头文件。QTextStream 类提供了很多种构造函数，常用的是：

QTextStream(QIODevice *device)

QIODevice 是 QFile 的父类，因此在构造 QTextStream 类的对象时，需要传递一个 QFile 类的对象。

下表罗列了 QTextStream 类常用的一些方法：

QTextStream 类重载了>>输入运算符和>>输出运算符，使读写文本文件变得更简单。例如，用 QTextStream 实现【实例一】的程序如下：

1. #include
2. #include
3. #include
4. #include
5. int main(int argc, char *argv[])
6. {
7. //创建 QFile 对象，同时指定要操作的文件
8. QFile file("D:/demo.txt");
9. //对文件进行写操作
10. if(!file.open(QIODevice::WriteOnly|QIODevice::Text)){
11. qDebug()<<"文件打开失败";
12. }
13. QTextStream out(&file);
14. //向文件中写入两行字符串
15. out << (QString)"C语言中文网\n" << (QString)"http://c.biancheng.net";
16. //关闭文件
17. file.close();
19. //重新打开文件，对文件进行读操作
20. if(!file.open(QIODevice::ReadOnly|QIODevice::Text)){
21. qDebug()<<"文件打开失败";
22. }
23. QTextStream in(&file);
24. //一直读，直至读取失败
25. while(!in.atEnd()){
26. QString str;
27. //从文件中读取一个字符串
28. in >> str;
29. qDebug() << str;
30. }
31. file.close();
32. return 0;
33. }

和类似，QTextStream 类提供了两种格式化输出的方法，一种是调用该类的成员方法，例如表 3 中的 setFieldAlignment()、setFieldWidth 等，另一种是调用 QTextStream 类提供的格式描述符，下表罗列了常用的一些：
 

举个简单的例子：

1. #include
2. #include
3. #include
4. #include
5. int main(int argc, char *argv[])
6. {
7. QFile file("D:/demo.txt");
8. if(!file.open(QIODevice::WriteOnly|QIODevice::Text)){
9. qDebug()<<"文件打开失败";
10. }
11. QTextStream out(&file);
12. //将 10 的十六进制数写入文件
13. out << hex << 10;
14. //设置每份数据占用 10 个字符的位置
15. out.setFieldWidth(10);
16. //以右对齐的方式写入 3.14
17. out << left << 3.14;
18. //后续数据以左对齐的方式写入文件
19. out.setFieldAlignment(QTextStream::AlignRight);
20. out << 2.7;
21. //关闭文件
22. file.close();
23. return 0;
24. }

程序运行后，demo.txt 存储的文本内容为：

a3.14             2.7

QFile+QDataStream

QDataStream 类的用法和 QTextStream 非常类似，最主要的区别在于，QDataStream 用于读写二进制文件。

使用 QDataStream 类之前，程序中要引入头文件。创建 QDataStream 对象常用的构造函数为：

QDataStream::QDataStream(QIODevice *d)

下表罗列了 QDataStream 类常用的成员方法：

QDataStream 类也对<<和>>进行了重载，举个简单的例子，用 QDataStream 重新实现实例二：

1. #include
2. #include
3. #include
4. int main(int argc, char *argv[])
5. {
6. //指定要写入文件的数据
7. qint32 nums[5]={1,2,3,4,5};
8. QFile file("D:/demo.dat");
9. file.open(QIODevice::WriteOnly);
10. //创建 QDataStream 对象
11. QDataStream out(&file);
12. //将 nums 数组中的整数逐个写入到二进制文件中
13. for(int i=0;i<5;i++){
14. out << nums[i];
15. }
16. file.close();
18. //再次打开文件，读取文件中存储的二进制数据
19. file.open(QIODevice::ReadOnly);
20. QDataStream in(&file);
21. //读取二进制文件中的数据
22. while(!in.atEnd()){
23. //每次读取一个整数
24. qint32 num;
25. in >> num;
26. qDebug() << num;
27. }
28. return 0;
29. }

输出结果为：

1
2
3
4
5