[转] - QBuffer类参考

QBuffer类参考

QBuffer类是一个操作QByteArray的输入/输出设备。 详情请见……

#include <qbuffer.h>

继承了QIODevice。

所有成员函数的列表。

公有成员

• QBuffer ()
• QBuffer ( QByteArray buf )
• ~QBuffer ()
• QByteArray buffer () const
• bool setBuffer ( QByteArray buf )
• virtual Q_LONG writeBlock ( const char * p, Q_ULONG len )
• Q_LONG writeBlock ( const QByteArray & data )

---

详细描述

QBuffer类是一个操作QByteArray的输入/输出设备。

QBuffer是用来读写内存缓存的。它通常与QTextStream或QDataStream一起使用。QBuffer有一个相关联的QByteArray用来存储缓冲数据。缓冲的大小（size()）会根据所写的数据自动调整。

构造函数QBuffer(QByteArray)以一个现有的字节数组创建一个QBuffer。字节数组也可以由setBuffer()来设置。向QBuffer写将会更改初始字节数组，因为QByteArray是明确共享。

在使用之前使用open()来打开缓存并且设置模式（只读、只写等等）。close()可以关闭缓存。在重新打开或者调用setBuffer()之前缓存必须被关闭。

使用QBuffer的一个普通方式是通过QDataStream或QTextStream，它们可以通过一个QBuffer参数来构造。为了方便，QDataStream和QTextStream也可以使用一个QByteArray参数来构造。这些构造函数创建并且打开一个内部的QBuffer。

注意QTextStream也可以操作QString（一个Unicode字符串），而QBuffer不能。

你也可以直接通过标准的QIODevice函数readBlock()、writeBlock()、readLine()、at(),、getch()、putch()和ungetch()来使用QBuffer。

也可以参考QFile、QDataStream、QTextStream、QByteArray、共享类、 集合类和输入/输出和网络。

---

成员函数文档

QBuffer::QBuffer ()

构造一个空的缓存。

QBuffer::QBuffer ( QByteArray buf )

操作buf来构造一个缓存。 如果你使用写模式（IO_WriteOnly或者IO_ReadWrite）打开缓存并且写一些东西到缓存，buf将被修改。

实例：

    QCString str = "abc";
    QBuffer b( str );
    b.open( IO_WriteOnly );
    b.at( 3 ); // 定位到第四个字符（终结符\0）
    b.writeBlock( "def", 4 ); // 写入“def”，包括终结符\0
    b.close();
    // 现在，str就是“abcdef”和一个终结符\0
  

也可以参考setBuffer()。

QBuffer::~QBuffer ()

析构缓存。

QByteArray QBuffer::buffer () const

返回这个缓存的字节数组。

也可以参考a href="#setBuffer">setBuffer()。

bool QBuffer::setBuffer ( QByteArray buf )

把缓存的内容替换为buf。

当isOpen()为真时，这个操作也许不能被完成。

注意如果你使用写模式（IO_WriteOnly或者IO_ReadWrite）打开缓存并且写一些东西到缓存，buf也会被修改因为QByteArray是一个明显共享类。

也可以参考buffer()、open()和close()。

Q_LONG QBuffer::writeBlock ( const char * p, Q_ULONG len ) [虚]

把p中的len字节写到缓存的当前索引位置，如果需要的话，将会覆盖原有的数据并且扩充缓存。返回实际所写的字节数量。

如果发生任何错误，返回-1。

也可以参卡readBlock()。

Reimplemented from QIODevice.

Q_LONG QBuffer::writeBlock ( const QByteArray & data )

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

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