qt中关于文件的操作

基本用法

QFile类是一个操作文件的输入/输出设备。

QFile是用来读写二进制文件和文本文件的输入/输出设备。QFile可以自己单独被使用，但是如果和QDataStream或QTextStream一起使用将更加方便。

文件名通常可以通过构造函数来传递，但也可以使用setName()来设置。你可以通过exists() 来检查一个文件是否存在并且可以通过remove()来移去一个文件。

文件可以用open() 来打开、用close() 来关闭、用flush() 来刷新。数据通常可以使用QDataStream或者QTextStream进行读写，但你也可以使用readBlock() 和readLine() 来读，使用writeBlock() 来写。QFile也支持getch()、 ungetch() 和putch()。

size() 可以返回文件的大小。你可以通过使用at() 函数得到当前文件位置或者移到一个新的文件位置。如果你到了文件的末尾，atEnd()返回真。handle()返回文件句柄。

这里是一个使用QTextStream来一行一行地读取一个文本文件的代码段。它会把每一行带上一个行号打印出来。

    QStringList lines;
    QFile file( "file.txt" );
    if ( file.open( IO_ReadOnly ) ) {
        QTextStream stream( &file );
        QString line;
        int n = 1;
        while ( !stream.eof() ) {
            line = stream.readLine(); // 不包括“/n”的一行文本
            printf( "%3d: %s/n", n++, line.latin1() );
            lines += line;
        }
        file.close();
    }
 

写文本也很容易（假设我们有一个行的字符串列表要写）：

    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();
    }

 

 

成员函数文档
QFile::QFile ()
构造一个没有名称的QFile。
QFile::QFile ( const QString & name )
构造一个文件名为name的QFile。

QFile::~QFile ()
析构QFile。调用close()。
bool QFile::at ( Offset pos ) [虚]
设置文件索引到pos。如果成功，返回真，否则返回假。

实例：

    QFile f( "data.bin" );
    f.open( IO_ReadOnly );                      // 索引设置为0
    f.at( 100 );                                // 设置索引为100
    f.at( f.at()+50 );                          // 设置索引为150
    f.at( f.size()-80 );                        // 设置索引为EOF之前的80
    f.close();
 
不带参数使用at() 可以重新得到文件的位移。

警告：如果文件是使用IO_Append方式打开（open()）的话，结果是未定义的。

bool QFile::atEnd () const [虚]
如果到达文件的末尾，返回真，否则返回假。

从QIODevice中重新实现的。
void QFile::close () [虚]
关闭一个打开的文件。

如果一个文件是使用一个存在的文件句柄打开的，那么它不是关闭的。如果这个存在的文件句柄是一个FILE*，这个文件被刷新。如果这个存在的文件句柄是一个int文件描述符，那么对这个文件将没有操作。

一些“在后面写的”文件系统也许会在关闭文件时报告一个未详细说明的错误。这些错误只表明在上一次打开（open()）之后也许发生了一些错误。在这种情况下，status() 会在关闭之后（close()）报告IO_UnspecifiedError，否则是IO_Ok。
bool QFile::exists ( const QString & fileName ) [静态]
如果给定的文件fileName存在，返回真，否则返回假。

void QFile::flush () [虚]
刷新文件缓存到磁盘。

close() 也刷新文件缓存。

int QFile::getch () [虚]
从文件中读取一个单字节/字符。
返回所读的字节/字符，如果到达文件的末尾，返回-1。

QString QFile::name () const
返回由setName() 设置的名称。

bool QFile::open ( int m ) [虚]
使用m模式和当前指定的文件名打开文件。如果成功，返回真，否则返回假。

模式参数m必须是下列标记的组合：

    * IO_Raw 指定直接的（非缓存的）文件访问。
    * IO_ReadOnly 以只读模式打开文件。
    * IO_WriteOnly 以只写模式（并且截短）打开文件。
    * IO_ReadWrite 以读/写模式打开文件，等于(IO_ReadOnly | IO_WriteOnly)。
    * IO_Append 以附加的模式打开文件。当你想向日志文件写些东西时这个模式非常有用。文件索引被设置到文件末尾。注意如果你在附加模式中使用at()定位文件索引，结果将是为定义的。
    * IO_Truncate 截短文件。
    * IO_Translate 在MS-DOS、Windows和OS/2下对文本文件翻译回车和换行。

直接访问模式在输入/输出的块操作使用4千字节或更大的情况下使用最好。当每次读小量数据时，缓存访问工作的更好。

重要：当使用缓存的文件工作时，数据没有被立刻写到文件中。调用flush()可以确保数据被真正地写完。

警告：如果你有一个缓存文件以同时读写方式打开，你不要在一次输入操作之后立即输出，反之亦然。你必须在输入和输出操作之间调用flush()或者一次文件定位操作，比如seek()，否则缓存中可能会包含无用信息。

如果文件不存在并且指定IO_WriteOnly或IO_ReadWrite时，文件被创建。

实例：

    QFile f1( "/tmp/data.bin" );
    QFile f2( "readme.txt" );
    f1.open( IO_Raw | IO_ReadWrite | IO_Append );
    f2.open( IO_ReadOnly | IO_Translate );

从QIODevice中重新实现的。
bool QFile::open ( int m, FILE * f )
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
使用m模式和一个存在的文件句柄f打开文件。如果成功，返回真，否则返回假。

实例：

    #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()并不真正关闭这个文件，只是刷新它。

警告：如果f是标准输入（stdin）、标准输出（stdout）、标准错误输出（stderr），你也许不能搜索。更详细的信息请看QIODevice::isSequentialAccess()。

bool QFile::open ( int m, int f )
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

使用m模式和一个存在的文件描述符f打开文件。如果成功，返回真，否则返回假。

当使用这个函数打开一个QFile时，close()并不真正关闭这个文件。

使用这个函数打开一个QFile时，它被自动设置为直接模式，这就意味着文件输入/输出函数是慢的。如果你需要更好的执行效率，请你试着使用其它打开函数。

警告：如果f是0（stdin）、1（stdout）或2（stderr）其中之一时，你也许不能搜索。size()被设置为INT_MAX（在limits.h文件中）。

int QFile::putch ( int ch ) [虚]
写字符ch到文件。

返回ch，或者如果发生错误，返回-1。


从QIODevice中重新实现的。
QByteArray QIODevice::readAll () [虚]
这个方便的函数返回这个设备中的所有剩余数据。
Q_LONG QFile::readBlock ( char * p, Q_ULONG len ) [虚]
从这个文件中读取最多maxlen字节到p并且返回实际读取的字节数量。

如果发生严重错误，返回-1。

警告：当一个缓存文件为了读写而打开时，我们已经在使用一些C库时遇到了问题。如果在一个写操作后立即执行一个读操作，读缓存中就会包含无用信息。更可怕的是，一些无用信息被写到文件中。在readBlock() 之前调用flush() 就可以解决这个问题。

从QIODevice中重新实现的。
Q_LONG QFile::readLine ( char * p, Q_ULONG maxlen ) [虚]
读一行文本。

从这个文本中读取最多maxlen字节或者行结束符到p，哪个先发生以哪个为准。返回实际读取的字节数量，或者如果发生错误，返回-1。换行将不会被省略。

这个函数只对缓存文件有效。避免在以IO_Raw标记方式打开的文件中使用readLine()。

从QIODevice中重新实现的。
Q_LONG QFile::readLine ( QString & s, Q_ULONG maxlen )
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

读一行文本。

从这个文本中读取最多maxlen字节或者行结束符到字符串s，哪个先发生以哪个为准。返回实际读取的字节数量，或者如果发生错误，返回-1。换行将不会被省略。

这个函数只对缓存文件有效。避免在以IO_Raw标记方式打开的文件中使用readLine()。

注意这个字符串只能作为无格式的Latin1字节来读，不是Unicode。

bool QFile::remove ()
移去当前指定文件名的文件。如果成功，返回真，否则返回假。

在文件被移去之前，它被关闭。
bool QFile::remove ( const QString & fileName ) [静态]
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。

移去文件fileName。如果成功，返回真，否则返回假。
void QFile::setDecodingFunction ( DecoderFn f ) [静态]
设置8位文件名的译码函数位f。默认使用本地指定的8位编码。

void QFile::setEncodingFunction ( EncoderFn f ) [静态]
设置Unicode文件名的编码函数为f。默认使用本地指定的8位编码。

void QFile::setName ( const QString & name )
设置文件的名称为name。这个名称可以不包含路径，也可以包含相对路径或者绝对路径。

如果文件已经被打开，不要调用这个函数。

如果文件名没有路径或者使用相对路径，这是使用的路径就是应用程序在调用open()的时候的当前路径。

实例：

     QFile f;
     QDir::setCurrent( "/tmp" );
     f.setName( "readme.txt" );
     QDir::setCurrent( "/home" );
     f.open( IO_ReadOnly );        // 在Unix下打开“/home/readme.txt”
 
注意Qt支持在所有的操作系统中使用目录分隔符“/”。

Offset QFile::size () const [虚]
返回文件大小。

从QIODevice中重新实现的。
int QFile::ungetch ( int ch ) [虚]

把字符ch放回到这个文件中并且如果索引位置不是零的话，减一。

这个函数正常地被调用就是“撤销”getch()操作。

返回ch，否则，如果发生错误，返回-1。