文件操作是应用程序必不可少的部分。Qt 作为一个通用开发库,提供了跨平台的文件操作能力。从本章开始,我们来了解下 Qt 的文件以及输入输出的功能,也就是 I/O 系统。
Qt 通过QIODevice
提供了对 I/O 设备的抽象,这些设备具有读写字节块的能力。下面是 I/O 设备的类图:
Qt4
Qt5
从上面的类图可以看出,Qt4 和 Qt5 在 I/O 设备部分大同小异。只不过 Qt5 新增加了一个QFileDevice
类。途中所涉及的类及其用途简要说明如下:
QIODevice
:所有 I/O 设备类的父类,提供了字节块读写的通用操作以及基本接口;QFlie
:访问本地文件或者嵌入资源;QTemporaryFile
:创建和访问本地文件系统的临时文件;QBuffer
:读写QByteArray
;QProcess
:运行外部程序,处理进程间通讯;QAbstractSocket
:所有套接字类的父类;QTcpSocket:TCP
协议网络数据传输;QUdpSocket
:传输 UDP 报文;QSslSocket
:使用 SSL/TLS 传输数据;QFileDevice:Qt5
新增加的类,提供了有关文件操作的通用实现。
这其中,QProcess
、QTcpSocket
、QUdpSoctet
和QSslSocket
是顺序访问设备。所谓“顺序访问”,是指它们的数据只能访问一遍:从头走到尾,从第一个字节开始访问,直到最后一个字节,中途不能返回去读取上一个字节;QFile
、QTemporaryFile
和QBuffer
是随机访问设备,可以访问任意位置任意次数,还可以使用QIODevice::seek()
函数来重新定位文件访问位置指针。
本章将主要介绍QFile
及其相关类,后面的章节则开始介绍有关输入输出的流。
在所有的 I/O 设备中,文件 I/O 是最重要的部分之一。因为我们大多数的程序依旧需要首先访问本地文件(当然,在云计算大行其道的将来,这一观点可能改变)。QFile
提供了从文件中读取和写入数据的能力。Qt5 新加入的QFileDevice
类,则将这部分公共操作放到了这个单独的类中。显然,这部分代码在 Qt4 中位于QFile
类。这样看来,Qt5 的代码结构更为清晰,层次更好。
我们通常会将文件路径作为参数传给QFile
的构造函数。不过也可以在创建好对象最后,使用setFileName()
来修改。QFile
需要使用 / 作为文件分隔符,不过,它会自动将其转换成操作系统所需要的形式。例如 C:/windows 这样的路径在 Windows 平台下同样是可以的。
QFile
主要提供了有关文件的各种操作,比如打开文件、关闭文件、刷新文件等。我们可以使用QDataStream
或QTextStream
类来读写文件,也可以使用QIODevice
类提供的read()
、readLine()
、readAll()
以及write()
这样的函数。值得注意的是,有关文件本身的信息,比如文件名、文件所在目录的名字等,则是通过QFileInfo
获取,而不是自己分析文件路径字符串。
下面我们使用一段代码来看看QFile
的有关操作:
int main(int argc, char *argv[]) { QApplication app(argc, argv); QFile file("in.txt"); if (!file.open(QIODevice::ReadOnly | QIODevice::Text)) { qDebug() << "Open file failed."; return -1; } else { while (!file.atEnd()) { qDebug() << file.readLine(); } } QFileInfo info(file); qDebug() << info.isDir(); qDebug() << info.isExecutable(); qDebug() << info.baseName(); qDebug() << info.completeBaseName(); qDebug() << info.suffix(); qDebug() << info.completeSuffix(); return app.exec(); }
在这段代码中,我们首先使用QFile
创建了一个文件对象。这个文件名字是 in.txt。如果你不知道应该把它放在哪里,可以使用可以使用app.applicationFilePath();
或者app.applicationDirPath();
来获得应用程序的执行路径。只要将这个文件放在同执行路径一致的目录下即可。QDir::currentPath()
来获得应用程序执行时的当前路径。只要将这个文件放在与当前路径一致的目录下即可。然后,我们使用open()
函数打开这个文件,打开形式是只读方式,文本格式。这个类似于fopen()
的 r 这样的参数。open()
函数返回一个 bool 类型,如果打开失败,我们在控制台输出一段提示然后程序退出。否则,我们利用 while 循环,将每一行读到的内容输出。
程序的第二部分,我们使用QFileInfo
获取有关该文件的信息。QFileInfo
有很多类型的函数,我们只举出一些例子。比如这里,isDir()
检查该文件是否是目录;isExecutable()
检查该文件是否是可执行文件等。baseName()
可以直接获得文件名;suffix()
则直接获取文件后缀名。我们可以由下面的示例看到,baseName()
和completeBaseName()
,以及suffix()
和completeSuffix()
的区别:
QFileInfo fi("/tmp/archive.tar.gz"); QString base = fi.baseName(); // base = "archive" QString cbase = fi.completeBaseName(); // base = "archive.tar" QString ext = fi.suffix(); // ext = "gz" QString ext = fi.completeSuffix(); // ext = "tar.gz"
12 评论
"如果你不知道应该把它放在哪里,可以使用 app.applicationFilePath(); 或者 app.applicationDirPath(); 来获得应用程序的执行路径。"
—— 应该吧 in.txt 放在“当前路径”吧,即QDir::currentPath()
是的,主要是看可执行程序执行时的当前路径,用 QDir::currentPath() 应该更好一些,感谢指出!原文已经修改过了。
❓ 在打开in.txt读取完内容之后不需要关闭文件吗?还是关闭窗口后会自动关闭?
程序关闭之后,操作系统会关闭我们打开的文件。由于我们只是简单的演示,这个也不伤大雅。不过如果是正式的程序,打开之后应该尽早关闭,以便释放对文件的占用,也会降低资源占用。
输出的中文有乱码
中文乱码一般是因为编码问题。注意 C++ 文件要使用 UTF-8 编码
qDebug()<<file.readLine().toStdString().c_str();这样才显示中文
晕。 前几天写了个小应用,不知道有QFileInfo,手动分离了。 前几天上不去,运气好差。X.X
不知道为什么,Open file failed. 我的文件夹也没有设置读取权限额;
sorry。是我没看清。要自己创建的; 我以为是像c/c++的fopen一样,不存在会自动创建;
你好,请问qt能以独占模式打开指定文件吗?
文档里面好像没有相关函数,有什么解决方法吗?
OSX 10.11
QDir::currentPath() 貌似有点问题,在非qtcreator工程中打开应用程序,返回的都是 根目录: "/"
而QCoreApplication::applicationFilePath()和工程中QDir::currentPath()的返回的都是mac app包内的可执行文件路径: "../myapp.app/Contents/MacOS"
stackoverflow:
http://stackoverflow.com/questions/23707866/qdir-absolutepath-on-mac/23709270#23709270
QT官方bug讨论:
http://forum.qt.io/topic/33440/qdir-currentpath-osx-10-9-mavericks-bug/2