QIODevice类是输入/输出设备的基类。
#include <qiodevice.h>
被QBuffer、QFile、QSocket和QSocketDevice继承。
公有成员
-
typedef off_t Offset
-
QIODevice ()
-
virtual ~QIODevice ()
-
int flags () const
-
int mode () const
-
int state () const
-
bool isDirectAccess () const
-
bool isSequentialAccess () const
-
bool isCombinedAccess () const
-
bool isBuffered () const
-
bool isRaw () const
-
bool isSynchronous () const
-
bool isAsynchronous () const
-
bool isTranslated () const
-
bool isReadable () const
-
bool isWritable () const
-
bool isReadWrite () const
-
bool isInactive () const
-
bool isOpen () const
-
int status () const
-
void resetStatus ()
-
virtual bool open ( int mode ) = 0
-
virtual void close () = 0
-
virtual void flush () = 0
-
virtual Offset size () const = 0
-
virtual Offset at () const
-
virtual bool at ( Offset pos )
-
virtual bool atEnd () const
-
bool reset ()
-
virtual Q_LONG readBlock ( char * data, Q_ULONG maxlen ) = 0
-
virtual Q_LONG writeBlock ( const char * data, Q_ULONG len ) = 0
-
virtual Q_LONG readLine ( char * data, Q_ULONG maxlen )
-
Q_LONG writeBlock ( const QByteArray & data )
-
virtual QByteArray readAll ()
-
virtual int getch () = 0
-
virtual int putch ( int ch ) = 0
-
virtual int ungetch ( int ch ) = 0
详细描述
QIODevice类是输入/输出设备的基类。
一个输入/输出设备代表了一个可从中读取字节和/和向它写字节的一种媒介。QIODevice类是一个所有这样的设备的抽象超类,像QFile、QBuffer和QSocket这些类继承了QIODevice类并且适当地实现了像write()这样地虚函数。
尽管应用程序有时直接使用QIODevice,但通常最好是通过提供了对任何一个QIODevice子类的流操作的QTextStream和QDataStream。QTextStream提供了基于文本的流的功能(比如对于人们是可读的ASCII文件),而QDataStream则可以以完全不依赖平台的方式处理二进制数据。
QIODevice中的公有成员可以粗略地分为两类:操作函数和状态访问函数。最主要的操作函数有:
- open() 打开一个用来读和/或写的设备,依赖于open()所使用的参数。
- close() 关闭设备并且整理好。
- readBlock() 从一个设备中读取一块数据。
- writeBlock() 向一个设备中写入一块数据。
- readLine() reads a line (of text, usually) from the device.
- flush() 确保所有的缓存数据都已经写入到真正的设备中。
这里是其它的一些不太常用的操作函数:
- getch() 读一个单字符。
- ungetch() 如果可能的话,忘记上一次对getch()的调用。
- putch() 写一个单字符。
- size() 如果有这个设备的话,返回它的大小。
- at() 如果这个设备存在一个当前读/写指针,就返回这个指针的位置,否则就移动这个指针。
- atEnd() 如果对于这个设备是有意义的问题的话,就会表示出是否还可以继续读。
- reset() 如果对于这个设备是可能的话,就移动读/写指针到这个设备的开始位置。
状态访问就是所有的“读取”函数。QIODevice子类调用setState()来更新状态,并且简单的访问函数告诉用户这个设备的状态。这里就是设置和与它们相配合的访问函数:
- 访问类型。 一些设备是被随机存取的(它可以在任何地方直接读/写),而其它的设备是顺序存取的。QIODevice提供了访问函数(isDirectAccess()、isSequentialAccess()和isCombinedAccess())来告诉用户一个给定的输入/输出设备所支持的。
- 缓存。 一些设备是以直接的模式被访问,而其它设备则使用缓存模式。缓存可以提供更高的效率,尤其是一些小的读/写操作。isBuffered()告诉用户给定的设备是否被缓存。(这通常可以通过应用程序调用open()来设置。)
- 同步性。 同步设备立即工作(比如文件)。当你从一个文件中读时,文件立刻传递它的数据。其它类型的设备,比如一个连接到HTTP服务器的套接字,也许在你命令它读取的几秒后才传递数据。isSynchronous()和isAsynchronous()会告诉用户如何操作这个设备的。
- 回车/换行翻译。 简单地说,应用程序通常喜欢看到只有一种单一的回车/换行风格,并且QIODevice子类可以提供这个。如果这个对象把回车/换行翻译成仅仅是换行,isTranslated()返回真。(这通常可以通过应用程序调用open()来设置。)
- 权限。 一些文件不能被写。比如,isReadable()、isWritable()和isReadWrite()告诉应用程序一个给定设备是否可读和可写。(这通常可以通过应用程序调用open()来设置。)
- 最后,如果设备是打开的话,比如在调用open()之后,isOpen()返回真。
QIODevice提供了大量的纯虚函数,你在继承它的时候需要实现这些函数。这里是一个子类的框架,其中包含了你所需要的全部成员和一些你也许需要的成员:
class MyDevice : public QIODevice { public: MyDevice(); ~MyDevice(); bool open( int mode ); void close(); void flush(); uint size() const; int at() const; // 非纯虚 bool at( int ); // 非纯虚 bool atEnd() const; // 非纯虚 int readBlock( char *data, uint maxlen ); int writeBlock( const char *data, uint len ); int readLine( char *data, uint maxlen ); int getch(); int putch( int ); int ungetch( int ); };
这里有三个非纯虚函数,它们对于顺序设备是可以不用实现的。