QFile详解

1、QFile::QFile()

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

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

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

3、boot QFile::atEnd()const [虚函数]

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

4、void QFile::close()[虚函数]

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

5、QStringQFile::decodeName(const QCString & localFileName) [静态函数]

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

6、QCStringQFile::encodeName(const QString & fileName) [静态函数]

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

7、bool QFile::exists(constQString &fileName) [静态函数]

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

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

将存放在缓冲区中的文件刷新输出到磁盘上。
注:close()也会将文件写入磁盘,并清除文件缓冲区。

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

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

10、int QFile::handle () const

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

11、QString QFile::name()const

返回被setName()设置的名字。

12、Bool QFile::open(intm)[虚函数]

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

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

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

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

14、bool QFile::open(int m,int f)

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

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

警告:如果f是0(stdin),1(stdout),2(stderr),你不能seek定位。Size()被设置成INT_MAX(inlimits.h)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

19、bool QFile::remove()

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

20、bool QFile::remove(constQString & fileName) [静态函数]

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

21、voidQFile::setDecodingFunction(DecoderFn f) [静态函数]

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

22、voidQFile::setEncodingFunction(EncoderFn f) [静态函数]

Sets the function for encodingUnicode file names to f. The default encodes in the locale-specific 8-bitencoding.

23、void QFile::setName(constQString & name)

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

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

返回文件大小。

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

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

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

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

posted @ 2019-10-11 11:10  YJCCN  阅读(4515)  评论(0编辑  收藏  举报