QFile详解

QFile 类是操作文件的输入输出设备类。QFile是一个用来读写二进制文件与文本文件的输入输出设备。QFile可 以被自己或更方便的类 DataStream或QTextStream使用。文件的名字通常通过构造传递，但可以通过setName（）来修改。你可以使用exists（）来检 查文件是否存在，并且通过remove（）来移除一个文件。文件通过open（）被打开，通过close（）来关闭，通过flush（）来更新。数据通常 使。QDataStream或QTextStream来被读出写入，但你可以通过readBlock（）和readLine()读出，通过 writeBlock（）写入。QFile还 支持getch（），ungetch（），putch（）。文件的大小可以通过size（）返回。你可以通过使用at（）函数来获得文件当前位置或移动到 一个新的文件位置。这里有一个代码片段，它使用QTextStream一行一行读一个文本文件。它以一个新的行号打印每一行。
　　　

　

 1 QStringList lines；
 2 　　　　QFile file（“file.txt”）；
 3 　　　　if （ file.open（IO_ReadOnly））
 4 　　　　{
 5 　　　　　　　　QTextStream stream（ &file ）；
 6 　　　　　　　　QString line；
 7 　　　　　　　　int i = 1；
 8 　　　　　　　　while ( ！stream . eof() )
 9 　　　　　　　　{
10 　　　　　　　　　　　　line = stream . readLine();
11 　　　　　　　　　　　　printf( "%3d:%s\n",i++,line.latin1());
12 　　　　　　　　　　　　lines += line;
13 　　　　　　　　}
14 　　　　　　　　file . close();
15 　　　　}

写文本一样容易。下面的例子显示了如何写入我们在上例中读到字符串列表里的数据：
　　　　

QFile file（"file.txt"）；
　　　　if (file . open(IO_WriteOnly))
　　　　{
　　　　　　　　QTextStream stream(&file);
　　　　　　　　for (QStringList :: Iterator it = lines.begin(); it != lines.end();++it)
　　　　　　　　　　　　stream << *it << "\n";
　　　　　　　　file . close();
　　　　}

QT 使用Unicode作为文件名字。如果你想在Unix系统上使用你自己的输入与输出，你应该使用encodeName和decodeName()莱转换文件名字到你本地的编码。

１、QFile：：QFile（）

构造一个没有名字的QFile对象

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

构造一个以name为文件名的QFile对象。
注：也可以QFile：：QFile（），然后调用setName()方法来实现类似动作。

３、boot QFile：：atEnd() const [虚函数]

如果已经到达文件末尾则返回TRUE，否则返回FALSE;

４、void QFile：：close() [虚函数]

关闭一个打开的文件。
如果文件被一个存在的文件句柄打开，则不能够关闭。如果存在的文件句柄是一个FILE *，文件会被刷新。如果存在的文件句柄是一个int型的文件描述符，对这个文件什么事情都不会做。

５、QString QFile::decodeName(const QCString & localFileName) [静态函数]

这是一个使用localFileName与QFile：：encodeName()相反的操作。

６、QCString QFile::encodeName(const QString & fileName) [静态函数]

当你使用QFile、QFileInfo与QDir来访问Qt的文件系统的时候，你可以使用Unicode的文件名字。在Unix系统上，这些文件 名称被转换成为一个8位编码的格式。如果你想在Unix上实现你自己的输入/输出文件，你需要使用这个函数来转换文件名称。在window NT/2000上，文件系统直接支持Unicode命名的文件，这个汗水就可以不适用了。在windows 95 上，这些事不支持的。默认的，这个函数转换文件名称到8为本地编码格式取决于用户的工作场合。这给用户给文件命名提供了丰富的选择空间。在应用程序中位文 件名字硬编码应该只选用7位ASCII码为文件名称字符。转换方案可以通过使用setEncodingFunction（）来改变。如果你希望给使用者一 个可以使用UTF-8编码命名存储文件的权利，那这个应该是很有用的，但是要知道这样一个文件名当其它程序使用时可能就不认识了。

７、bool QFile::exists(const QString &fileName) [静态函数]

如果给定fileName名的文件存在则返回TRUE，否则返回FALSE。
注：另一个重载函数为boot QFile::exists() const，如果setName()设定的文件存在则返回TRUE，否则返回FALSE。

８、void QFile::flush() [虚函数]

将存放在缓冲区中的文件刷新输出到磁盘上。
注：close（）也会将文件写入磁盘，并清除文件缓冲区。

９、int QFile::getch() [虚函数]

从一个文件中读一个字节/字符。
返回读取的字节/字符。如果到达文件的尾部则返回-1.

１０、int QFile::handle () const

返回文件的句柄。
这是一个短整型，与C库函数例如fopen()与fcntl（）的使用类似，以及与QSocketNotifier类似。
如果文件没有打开或有错误，handle（）返回-1.

１１、QString QFile：：name（） const

返回被setName（）设置的名字。

１２、Bool QFile：：open（int m） [虚函数]

１３、bool QFile::open(int m,FILE *f)

这是一个为了方便而提供的重载成员函数。它在本质表现上类似于上面的函数。它使用一个存在的文件句柄并以参数m模式打开它。如果成功它返回TRUE，否则返回FALSE。
例子：
　　　　#include <stdio.h>

　　　　void printError(const char * msg)
　　　　{
　　　　　　　　QFile f;
　　　　　　　　f.open(IO_WriteOnly,stderr);
　　　　　　　　f.writeBlock(msg,qstrlen(msg));//向stderr中写入
　　　　　　　　f.close();
　　　　}
当QFile使用这个功能打开一个文件时，close（）实质上不能关闭文件，只有flushes它了。

警告：如果f是stdin，stdout,stderr，你不能seek定位。

１４、bool QFile::open(int m,int f)

　　这是一个为了方便而提供的重载成员函数。它本质表现上类似于上述函数。它使用一个已经存在的文件描述符，以模式m打开这个文件。如果成功返回TRUE，否则返回FALSE。当QFile使用这个功能打开一个文件时，close（）实质上不能关闭文件。

使用这个函数打开的QFile文件，会自动的被设置成不带缓冲区的模式，这意味着文件输入与输出操作会慢。如果你达到发布执行的时候，你应该试着使用其它的打开函数。

警告：如果f是0（stdin），1（stdout）,2（stderr），你不能seek定位。Size（）被设置成INT_MAX(in limits.h)

１５、int QFile::putch (int ch) [虚函数]

像文件当中写入字符ch。
返回ch，或如果发生错误返回-1

１６、QByteArry QIODevice::readAll() [虚函数]

这个方便的函数返回所有在设备上剩余数据。

１７、Q_LONG QFile::readLine (char *p,Q_ULONG maxlen ) [虚函数]

读取去文本中的一行数据。

从文件中读取的数据存放到以字符指针p开始位置处，直到一行结束或达到maxlen长度字节处无论哪个先发生都会返回。返回读到字节的长度数值，或发生错误后返回-1。返回内容包含终止换行符。

这个函数只有在文件存放在缓冲区中才有效率。避免在使用IO_Raw标志打开文件后使用readLine()操作文件。

１８、Q_LONG OFile::readLine(QString &s,Q_ULONG maxlen)

这是为了方便操作而提供的一个重载成员函数。它实质上的功能与上面的函数类似。

从一个文件中读一行数据。

从文件中读出多个字节存放到字符串s中，直到一行结束或达到maxlen长度字节处无论哪个先发生都会返回。返回读到字节的长度数值，或发生错误后返回-1。返回内容包含终止换行符。

这个函数只有在文件存放在缓冲区中才有效率。避免在使用IO_Raw标志打开文件后使用readLine()操作文件。

注意：这个字符串以plain Latin1模式读出来的，不是Unicode。

１９、bool QFile::remove()

根据当前设置的文件名删除文件。如果成功返回TRUE，否则返回FALSE。
在移除文件前这个文件要被关闭掉。

２０、bool QFile::remove(const QString & fileName) [静态函数]

这是一个很有用的可重载成员函数。它本质上的功能类似于上面的函数。它移除指定名称的文件。如果成功返回TRUE，否则返回FALSE。

２１、void QFile::setDecodingFunction(DecoderFn f) [静态函数]

警号：这个函数是不可重入函数。
Sets the function for decoding 8-bit file names to f. The default uses the locale-specific 8-bit encoding.

２２、void QFile::setEncodingFunction(EncoderFn f) [静态函数]

Sets the function for encoding Unicode file names to f. The default encodes in the locale-specific 8-bit encoding.

２３、void QFile::setName(const QString & name)

设置文件对象的名字为name。这个名字可以不包含路径或相对路径或绝对路径。如果文件已经被打开，那么不要调用这个函数。如果文件名不包含路径或相对路径，那么无论什么时候在执行open（）调用时应用程序当前目录就会被使用。
示例：
　　　　QFile file；
　　　　QDir::setCurrent("/tmp");
　　　　file . setName("readme.txt");
　　　　QDir::setCurrent("/home");
　　　　file . open(IO_ReadOnly); //打开文件的位置"/home/readme.txt"

２４、Offset QFile::size() const [虚函数]

返回文件大小。

２５、int QFile::ungetch (int ch) [虚函数]

输出字符ch返回到文件中，并且如果不为零则减少数值。

这个函数通常在撤销getch（）操作的时候调用。

返回ch，或当错误发生的时候返回-1。