主页 | 所有的类 | 主要的类 | 注释的类 | 分组的类 | 函数

QIODevice类参考

QIODevice类是输入/输出设备的基类。 详情请见……

#include <qiodevice.h>

QBufferQFileQSocketQSocketDevice继承。

所有成员函数的列表。

公有成员


详细描述

QIODevice类是输入/输出设备的基类。

一个输入/输出设备代表了一个可从中读取字节和/和向它写字节的一种媒介。QIODevice类是一个所有这样的设备的抽象超类,像QFileQBufferQSocket这些类继承了QIODevice类并且适当地实现了像write()这样地虚函数。

尽管应用程序有时直接使用QIODevice,但通常最好是通过提供了对任何一个QIODevice子类的流操作的QTextStreamQDataStream。QTextStream提供了基于文本的流的功能(比如对于人们是可读的ASCII文件),而QDataStream则可以以完全不依赖平台的方式处理二进制数据。

QIODevice中的公有成员可以粗略地分为两类:操作函数和状态访问函数。最主要的操作函数有:

这里是其它的一些不太常用的操作函数:

状态访问就是所有的“读取”函数。QIODevice子类调用setState()来更新状态,并且简单的访问函数告诉用户这个设备的状态。这里就是设置和与它们相配合的访问函数:

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

这里有三个非纯虚函数,它们对于顺序设备是可以不用实现的。

也可以参考QDataStreamQTextStream输入/输出和网络


成员类型文档

QIODevice::Offset

设备中的位移。

成员函数文档

QIODevice::QIODevice ()

构造一个输入/输出设备。

QIODevice::~QIODevice () [虚]

析构一个输入/输出设备。

Offset QIODevice::at () const [虚]

虚函数返回当前输入/输出设备位置。

这是输入/输出设备读/写数据的头的位置。

也可以参考size()。

QFileQSocket中被重新实现。

bool QIODevice::at ( Offset pos ) [虚]

这是一个重载成员函数,提供了更多方便。它的行为和上面的函数基本一致。

虚函数设置输入/输出位置到pos。如果位置设置成功,返回真,比如pos是在范围之内,否则返回假。

也可以参考size()。

QFileQSocket中被重新实现。

bool QIODevice::atEnd () const [虚]

如果输入/输出设备位置在输入的末尾位置时,虚函数返回真,否则返回假。

QFileQSocket中被重新实现。

void QIODevice::close () [纯虚]

关闭输入/输出设备。

这个虚函数在所有的子类中必须被重新实现。

也可以参考open()。

实例:grapher/grapher.cpp

QFileQSocket中被重新实现。

int QIODevice::flags () const

返回当前输入/输出设备标记设置。

标记由模式标记和状态标记组成。

也可以参考mode()和state()。

void QIODevice::flush () [纯虚]

刷新一个打开的输入/输出设备。

这个虚函数在所有的子类中必须被重新实现。

QFileQSocket中被重新实现。

int QIODevice::getch () [纯虚]

从输入/输出设备中读取一个单一的字节/字符。

返回所读取的字节/字符,或者是如果到了输入/输出设备的终点,返回-1。

这个虚函数在所有的子类中必须被重新实现。

也可以参考putch()和ungetch()。

QFileQSocket中被重新实现。

bool QIODevice::isAsynchronous () const

如果这个输入/输出设备是一个异步设备,返回真,否则返回假,比如,如果这个设备是一个同步设备。

这个模式当前不在使用中。

也可以参考isSynchronous()。

bool QIODevice::isBuffered () const

如果这个输入/输出设备是一个被缓存的设备,返回真,否则返回假,比如,如果这个设备是一个直接的设备。

也可以参考isRaw()。

bool QIODevice::isCombinedAccess () const

如果这个输入/输出设备是一个组合存取(既可以随机存取也可以顺序存取)的设备,返回真,否则返回假。

这个访问方法当前不在使用中。

bool QIODevice::isDirectAccess () const

如果这个输入/输出设备是一个随机存取的设备,返回真,否则返回假,比如,如果这个设备是一个顺序存取的设备。

也可以参考isSequentialAccess()。

bool QIODevice::isInactive () const

如果这个输入/输出设备状态是0,返回真,比如,这个设备没有打开,否则返回假。

也可以参考isOpen()。

bool QIODevice::isOpen () const

如果这个输入/输出设备已经被打开,返回真,否则返回假。

也可以参考isInactive()。

实例:network/networkprotocol/nntp.cpp

bool QIODevice::isRaw () const

如果这个输入/输出设备是一个直接设备,返回真,否则返回假,比如,如果这个设备是一个被缓存的设备。

也可以参考isBuffered()。

bool QIODevice::isReadWrite () const

如果这个输入/输出设备被使用IO_ReadWrite模式打开,返回真,否则返回假。

也可以参考isReadable()和isWritable()。

bool QIODevice::isReadable () const

如果这个输入/输出设备被使用IO_ReadOnlyIO_ReadWrite 模式打开,返回真,否则返回假。

也可以参考isWritable()和isReadWrite()。

bool QIODevice::isSequentialAccess () const

如果这个输入/输出设备是一个顺序存取的设备,返回真,否则返回假,比如,如果这个设备是一个随机存取的设备。

包括size()和at(int)的操作在顺序存取的设备上都是无效的。

也可以参考isDirectAccess()。

bool QIODevice::isSynchronous () const

如果这个输入/输出设备是一个同步设备,返回真,否则返回假,比如,如果这个设备是一个异步设备。

也可以参考isAsynchronous()。

bool QIODevice::isTranslated () const

如果这个输入/输出设备翻译回车/换行,返回真,否则返回假。

如果QFile是以IO_Translate模式标记打开的,它就是被翻译的。

bool QIODevice::isWritable () const

如果这个输入/输出设备被使用IO_WriteOnlyIO_ReadWrite模式打开,返回真,否则返回假。

也可以参考isReadable()和isReadWrite()。

int QIODevice::mode () const

返回指定的当前操作模式的位或运算的结果。

这里是提供给open()函数的标记。

这些标记是IO_ReadOnlyIO_WriteOnlyIO_ReadWriteIO_AppendIO_TruncateIO_Translate

bool QIODevice::open ( int mode ) [纯虚]

使用指定的mode打开输入/输出设备。如果这个设备被成功打开,返回真,否则返回假。

模式参数mode必须是下列标记的或的组合。

这个虚函数在所有的子类中必须被重新实现。

也可以参考close()。

实例:grapher/grapher.cpp

QFileQSocket中被重新实现。

int QIODevice::putch ( int ch ) [纯虚]

向输入/输出设备写入字符ch

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

这个虚函数在所有的子类中必须被重新实现。

也可以参考getch()和ungetch()。

实例:grapher/grapher.cpp

QFileQSocket中被重新实现。

QByteArray QIODevice::readAll () [虚]

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

Q_LONG QIODevice::readBlock ( char * data, Q_ULONG maxlen ) [纯虚]

从这个输入/输出设备中读取最多maxlen字节到data并且返回实际读取的字节数量。

如果发生致命错误,这个函数应该返回-1。

这个虚函数在所有的子类中必须被重新实现。

也可以参考writeBlock()。

QFileQSocketQSocketDevice中被重新实现。

Q_LONG QIODevice::readLine ( char * data, Q_ULONG maxlen ) [虚]

读取文本的一行,(或者如果还没有遇到新的一行的情况下,读取maxlen字节)加上一个结束符\0到data。如果这一行后面还有新的一行,就不再做上述的操作了。

返回包括终结符\0的所读字节数,或者如果发生错误返回-1。

这个虚函数在绝大多数子类中被重新实现的话能够提供更高的效率。

也可以参考readBlock()和QTextStream::readLine()。

QFile中被重新实现。

bool QIODevice::reset ()

设置这个设备索引位置为0。

也可以参考at()。

void QIODevice::resetStatus ()

设置这个输入/输出设备状态为IO_Ok

也可以参考status()。

Offset QIODevice::size () const [纯虚]

虚函数返回输入/输出设备的大小。

也可以参考at()。

QFileQSocket中被重新实现。

int QIODevice::state () const

返回指定当前状态的位或运算结果。

这个标记是:IO_Open

子类也可以定义另外的标记。

int QIODevice::status () const

返回这个输入/输出设备的状态。

这个输入/输出设备状态返回一个错误码。如果open()返回失败或者readBlock()或writeBlock()返回-1,这个函数就可以被调用来发现操作为什么不成功的原因。

状态码是:

也可以参考resetStatus()。

int QIODevice::ungetch ( int ch ) [纯虚]

把字符ch放回到这个输入/输车设备中并且如果索引位置不是零的话,减一。

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

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

这个虚函数在所有的子类中必须被重新实现。

也可以参考getch()和putch()。

QFileQSocket中被重新实现。

Q_LONG QIODevice::writeBlock ( const char * data, Q_ULONG len ) [纯虚]

data中写len字节到这个输入/输出设备并且返回实际写的字节数。

如果发生致命错误,这个函数应该返回-1。

这个虚函数在所有的子类中必须被重新实现。

也可以参考readBlock()。

QBufferQSocketQSocketDevice中被重新实现。

Q_LONG QIODevice::writeBlock ( const QByteArray & data )

这是一个重载成员函数,提供了方便。它的行为和上面的函数基本一致。

这个方便的函数与调用writeBlock( data.data(), data.size() )是一样的。


这个文件是Qt工具包一部分。 版权所有 © 1995-2002 Trolltech。保留所有权利。


Copyright © 2002 Trolltech Trademarks 译者:Cavendish
Qt 3.0.5版