QT开发（二十八）——QT常用类（二）

QT开发（二十八）——QT常用类（二）

一、QDir

1、QDir简介

QDir提供对目录结构及其内容的访问。
QDir通过相对或绝对路径指向一个文件。

2、QDir成员函数

QDir主要成员函数如下：
QDir::QDir ( const QDir & dir )
QDir::QDir ( const QString & path = QString() )
Dir::QDir ( const QString & path, const QString & nameFilter, SortFlags sort = SortFlags( Name | IgnoreCase ),Filters filters = AllEntries )
构造函数
QString QDir::absoluteFilePath ( const QString & fileName ) const
返回目录中文件的绝对路径
QString QDir::absolutePath () const
返回绝对路径，不包括.和..
bool QDir::cd ( const QString & dirName )
切换到目录uint QDir::count () const
返回目录中文件和目录的数量QDir QDir::current () [static]
返回应用程序的当前目录QString QDir::currentPath () [static]
返回应用程序当前目录的绝对路径QFileInfoList QDir::entryInfoList(const QStringList & nameFilters, Filters filters = NoFilter, SortFlags sort = NoSort) const
QFileInfoList QDir::entryInfoList(Filters filters = NoFilter, SortFlags sort = NoSort) const
返回目录中所有文件与目录的QFileInfo对象链表QStringList QDir::entryList(const QStringList & nameFilters, Filters filters = NoFilter, SortFlags sort = NoSort) const
QStringList QDir::entryList(Filters filters = NoFilter,
SortFlags sort = NoSort) const
返回目录中所有文件与目录的名字的链表
bool QDir::exists(const QString & name) const
如果name文件存在返回true
bool QDir::exists() const
如果目录存在，返回true
bool QDir::isAbsolute() const
如果目录路径是绝对路径，返回true
bool QDir::isAbsolutePath(const QString & path) [static]
如果路径path是绝对路径，返回true
bool QDir::makeAbsolute()
将目录路径转化为绝对路径
bool QDir::mkdir(const QString & dirName) const
创建一个dirNanme的子目录
bool QDir::mkpath(const QString & dirPath) const
创建dirPath目录路径
void QDir::setSorting(SortFlags sort)
设置排序方式
void QDir::setFilter(Filters filters)
设置过滤器
bool QDir::setCurrent(const QString & path) [static]
将path设置为应用程序的当前工作目录
bool QDir::remove(const QString & fileName)
删除文件fileName
bool QDir::rename(const QString & oldName, const QString & newName)
将文件或目录oldName重命名为newName
bool QDir::rmdir(const QString & dirName) const
删除指定目录dirName
bool QDir::rmpath(const QString & dirPath) const
删除指定目录路径dirPath

二、QFile

1、QFile简介

QFile提供了读写文件的接口，是读写文本文件、二进制文件、资源文件的I/O设备。QT4版本的QIODevice类图如下：



QT5版本的QIODevice类图如下：



各个类的用途如下： 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是随机访问设备。QFile提供了从文件中读取和写入数据的能力，QFile主要提供了有关文件的各种操作，比如打开文件、关闭文件、刷新文件等。有关文件本身的信息，比如文件名、文件所在目录的名字等，则是通过 QFileInfo 获取。

2、QFile成员函数

QFile主要成员函数如下：QFile::QFile ( const QString & name )
QFile::QFile ( QObject * parent )
QFile::QFile ( const QString & name, QObject * parent )
构造函数bool QFile::open ( OpenMode mode ) [virtual]
bool QFile::open ( FILE * fh, OpenMode mode )
bool QFile::open ( int fd, OpenMode mode )
打开文件qint64 QFile::readData(char * data, qint64 len)[virtual protected]
qint64 QFile::readLineData(char * data, qint64 maxlen)[virtual protected]
读取数据qint64 QFile::writeData(const char * data, qint64 len)[virtual protected]
写入数据void QFile::close () [virtual]
关闭文件bool QFile::copy(const QString & newName)
拷贝当前文件到newName文件
bool QFile::copy(const QString & fileName,const QString & newName)[static]拷贝fileName文件到newName文件
bool QFile::exists ( const QString & fileName ) [static]
bool QFile::exists () const
文件是否存在bool QFile::atEnd () const [virtual]
如果到达文件结束，返回trueQString QFile::fileName () const
返回文件名bool QFile::remove ()
bool QFile::remove ( const QString & fileName ) [static]
删除文件bool QFile::rename ( const QString & newName )
bool QFile::rename(const QString & oldName, const QString & newName)[static]重命名文件void QFile::setFileName ( const QString & name )
设置文件名void QFile::setDecodingFunction ( DecoderFn function ) [static]
设置解码函数
void QFile::setEncodingFunction ( EncoderFn function ) [static]
设置编码函数

一、QFileInfo

1、QFileInfo简介

QFileInfo提供了独立与系统的文件信息。QFileInfo提供了文件系统中文件的名字与路径、访问权限和是否是目录或符号链接的信息。

2、QFileInfo成员函数

QDir QFileInfo::absoluteDir() const
返回文件的绝对路径QString QFileInfo::absoluteFilePath() const
返回包含文件名的文件的绝对路径QString QFileInfo::absolutePath() const
返回不包含文件名的文件的绝对路径QString QFileInfo::baseName() const
返回不带路径的文件的基本名字，不带任何文件后缀QString QFileInfo::completeBaseName() const
返回不带路径的文件的完整基本名字，不带最后一个后缀QString QFileInfo::completeSuffix() const
返回文件的完整后缀QDateTime QFileInfo::created() const
返回创建文件的日期和时间QDir QFileInfo::dir() const
返回对象的父目录的路径QString QFileInfo::fileName() const
返回文件名，不包含路径QString QFileInfo::filePath() const
返回包含路径的文件名QString QFileInfo::path() const
返回不包括文件名的文件路径qint64 QFileInfo::size() const
返回文件的大小QString QFileInfo::suffix() const
返回文件的后缀QString QFileInfo::symLinkTarget() const
返回符号链接指向的文件或目录的绝对路径

二、QDataStream

1、QDataStream简介

QDataStream 提供了基于 QIODevice 的二进制数据的序列化。数据流是一种二进制流，完全不依赖于底层操作系统、CPU 或者字节顺序（大端或小端）。例如，在安装了Windows平台的 PC 上面写入的一个数据流，可以不经过任何处理，直接拿到运行了Solaris的SPARC机器上读取。由于数据流就是二进制流，因此我们也可以直接读写没有编码的二进制数据，例如图像、视频、音频等。
QDataStream既能够存取C++基本类型，如int、char、short等，也可以存取复杂的数据类型，例如自定义的类。实际上，QDataStream 对于类的存储，是将复杂的类分割为很多基本单元实现的。
数据流和QIODevice紧密配合使用。QIODevice是读取数据和写入数据的输入输出中介。写入二进制数据到流代码如下：QFile file("file.dat");
file.open(QIODevice::WriteOnly);
//串行化数据到到文件
QDataStream out(&file);
//串行输出一个字符串
out << QString("the answer is");
//串行输出一个整型
out << (qint32)42;
从流中读取二进制数据：
QFile file("file.dat");
file.open(QIODevice::ReadOnly);
//从文件中串行化读取数据
QDataStream in(&file);
QString str;
qint32 a;
//从文件中读物字符串和整型
in >> str >> a;
当输入输出复杂类型时，确保读出流和写入流的版本相同是非常重要的。如果需要流操作的前后兼容，需要在应用程序在硬编码版本号。
stream.setVersion(QDataStream::Qt_4_0);
如果要生成新的二进制数据格式，如由应用程序创建的文档文件格式，可以使用QDataStream以兼容格式写入数据。通常，为了给程序未来扩展留有余地，可以写入包含魔术字符串和版本号的简要头信息。
QFile file("file.xxx");
file.open(QIODevice::WriteOnly);
QDataStream out(&file);
// Write a header with a "magic number" and a version
out << (quint32)0xA0B0C0D0;
out << (qint32)123;
out.setVersion(QDataStream::Qt_4_0);
// Write the data
out << lots_of_interesting_data;
读取数据的代码如下：
QFile file("file.xxx");
file.open(QIODevice::ReadOnly);
QDataStream in(&file);
// Read and check the header
quint32 magic;
in >> magic;
if (magic != 0xA0B0C0D0)
return XXX_BAD_FILE_FORMAT;
// Read the version
qint32 version;
in >> version;
if (version < 100)
return XXX_BAD_FILE_TOO_OLD;
if (version > 123)
return XXX_BAD_FILE_TOO_NEW;
if (version <= 110)
in.setVersion(QDataStream::Qt_3_2);
else
in.setVersion(QDataStream::Qt_4_0);
// Read the data
in >> lots_of_interesting_data;
if (version >= 120)
in >> data_new_in_XXX_version_1_2;
in >> other_interesting_data;
当串行化数据时，可以选择要使用的字节序。默认设置的字节序是大端。字节序设置为小端将会破坏兼容性，除非读取的时候也使用小端。除非有特殊需求，一般使用默认设置的字节序。
直接从流中读取原生二进制数据使用readRawData()函数，写入原生二进制数据到流使用writeRawData()函数，但数据的编解码必须自己完成。
与readRawData()函数不同，readBytes()函数读取一个quint32长度的数据到预分配的内存空间；writeBytes()写入quint32长度的数据。任何不同于quint32长度的数据的编解码必须自己完成。
QT容器类可以串行化到QDataStream，包括QList、QLinkedList、QVector、QSet、QHash和QMap。
当在异步设备上使用数据流时，数据中的大部分都能在任意时间点到达。QDataStream实现了使用一系列流操作符自动读取数据的事务机制。

2、QDataStream成员函数

QDataStream::QDataStream(QIODevice *d)
QDataStream::QDataStream(QByteArray *a, QIODevice::OpenMode mode)
QDataStream::QDataStream(const QByteArray &a)
构造函数void QDataStream::abortTransaction()
中止一个读取事务bool QDataStream::atEnd() const
如果IO设备到达文件或流的结束位置，返回true
ByteOrder QDataStream::byteOrder() const
返回当前字节序设置
bool QDataStream::commitTransaction()
返回一个读取事务，如果事务中没有发生读错误，返回true
QIODevice *QDataStream::device() const
返回当前设置的IO设备，如果没有设置，返回0
FloatingPointPrecision QDataStream::floatingPointPrecision() const返回数据流的浮点精度QDataStream &QDataStream::readBytes(char *&s, uint &l)
从流中读取缓冲区s，返回流的引用int QDataStream::readRawData(char *s, int len)
从流中读取至多len字节到缓冲区s，返回读取的字节数，发生错误，返回-1void QDataStream::resetStatus()
重置数据流的状态void QDataStream::rollbackTransaction()
恢复一个读事务void QDataStream::setByteOrder(ByteOrder bo)
设置串行化字节序到bovoid QDataStream::setDevice(QIODevice *d)
设置IO设备到dvoid QDataStream::setFloatingPointPrecision(FloatingPointPrecision precision)
设置数据流的浮点精度到precisionvoid QDataStream::setStatus(Status status)
设置数据流的状态为给定状态status
void QDataStream::setVersion(int v)
设置数据串行化的版本到v
为了适应新的功能，在某些QT版本中，一些QT类数据流串行化格式已经做出了改变。如果想读取在早期QT版本创建的数据，或是写只有在早期QT版本编译的程序中才能读取的数据，需要修改数据流串行化格式。
int QDataStream::skipRawData(int len)
跳过设备中的len个字节，返回实际跳过的字节数
void QDataStream::startTransaction()
在流中启动一个新的读事务
Status QDataStream::status() const
返回数据流的状态
int QDataStream::version() const
返回数据串行化格式的版本号
QDataStream &QDataStream::writeBytes(const char *s, uint len)
写长度为len的缓冲区s到流，返回流的引用
int QDataStream::writeRawData(const char *s, int len)
从s中写len字节到流

五、QTextStream

1、QTextStream简介

QTextStream为读写文本提供了实用接口。QTextStream可以操作QIODevice、QByteArray 、QString数据。使用QTextStream的流操作符，可以方便读写字、行、数字。QTextStream支持字段填充、对齐的格式化选项和数字格式化。
QFile data("output.txt");
if (data.open(QFile::WriteOnly | QFile::Truncate))
{
QTextStream out(&data);
out << "Result: " << qSetFieldWidth(10) << left << 3.14 << 2.7;
// writes "Result: 3.14 2.7 "
}
通常使用QTextStream读取控制台输入和写入控制台输出。QTextStream支持本地化，会使用正确codec编解码器自动解码标准输入。
QTextStream stream(stdin);
QString line;
while (stream.readLineInto(&line))
{
...
}
除了使用QTextStream构造函数，可以使用setDevice()或setString()设置流的设备或字符串。使用seek()函数定位位置，如果没有数据可读，atEnd()函数会返回true。
QTextStream在内使用基于Unicode编码的缓冲区，使用QTextCodec编译码器自动支持不同的字符集。默认，QTextCodec::codecForLocale()用于读写，但也能调用setCodec()设置编译码器。自动支持Unicode编码检测是默认行为，当读取的时候，QTextStream会检测UTF-16或是UTF-32 BOM并且自动选择合适的编解码器。QTextStream默认不会以BOM方式写，但是可以调用setGenerateByteOrderMark(true)设置。QTextStream直接操作QString时，编译码器codec是失效的。
默认，从文本流中读取数字时，QTextStream会自动检测数字的进制。如果数字以0x开头会被假设为16进制；数字以1--9开头，会被假设为10进制。

2、QTextStream成员函数

QTextStream::QTextStream(QIODevice *device)
QTextStream::QTextStream(FILE *fileHandle, QIODevice::OpenMode openMode = QIODevice::ReadWrite)
QTextStream::QTextStream(QString *string, QIODevice::OpenMode openMode = QIODevice::ReadWrite)
QTextStream::QTextStream(QByteArray *array, QIODevice::OpenMode openMode = QIODevice::ReadWrite)
QTextStream::QTextStream(const QByteArray &array, QIODevice::OpenMode openMode = QIODevice::ReadOnly)
构造函数bool QTextStream::atEnd() const
流中不再有数据可读，返回truebool QTextStream::autoDetectUnicode() const
如果自动Unicode检测打开，返回trueQTextCodec *QTextStream::codec() const
返回流的当前的编解码器QIODevice *QTextStream::device() const
返回流关联的当前设备
FieldAlignment QTextStream::fieldAlignment() const
返回当前的字段对齐方式int QTextStream::fieldWidth() const
返回当前字段宽度void QTextStream::flush()
刷新任何在等待的缓冲区数据，写入到设备bool QTextStream::generateByteOrderMark() const
当使用UTF编解码器时，如果流设置为UTF BOM，返回trueint QTextStream::integerBase() const
返回整数的进制QLocale QTextStream::locale() const
返回命令设置语言环境，默认为CQChar QTextStream::padChar() const
返回当前的填充字符QString QTextStream::read(qint64 maxlen)
从流中读取至多len字节，返回读取的数据QStringQString QTextStream::readAll()
读取流中的所有内容QString QTextStream::readLine(qint64 maxlen = 0)
从流中读取一行文本，返回的字符串不包含行结束符允许行的最大长度为maxlen，如果maxlen为0，则为允许任何长度void QTextStream::setCodec(QTextCodec *codec)
设置流的编解码器为codecvoid QTextStream::setCodec(const char *codecName)
设置流的编解码器codec为指定名字codecName的编码，通常为ISO 8859-1、UTF-8、UTF-16
void QTextStream::setDevice(QIODevice *device)
设置当前设备到device，如果已经有设备，取代旧的设备
void QTextStream::setFieldAlignment(FieldAlignment mode)
设置字段对齐方式
void QTextStream::setFieldWidth(int width)
设置字段宽度
void QTextStream::setIntegerBase(int base)
设置整数进制
void QTextStream::setLocale(const QLocale &locale)
设置流的本地环境为locale
void QTextStream::setPadChar(QChar ch)
设置填充字符为ch
void QTextStream::setString(QString *string, QIODevice::OpenMode openMode = QIODevice::ReadWrite)
设置当前的字符串到string，打开方式为openMode
QString *QTextStream::string() const
返回流所赋值的字符串，如果没有字符串，返回0