QBuffer 类

成员函数文档

[显式] QBuffer::QBuffer(QObject *parent = nullptr)

使用指定的 parent 构造一个空的缓冲区。你可以调用 setData() 来填充缓冲区中的数据，或者你可以在写入模式下打开它，并使用 write()。

另请参阅: open。

QBuffer::QBuffer(QByteArray *byteArray, QObject *parent = nullptr)

使用由 byteArray 所指的 QByteArray 作为其内部缓冲区的一个 QBuffer，和给定的 parent。调用者负责确保 byteArray 在 QBuffer 被销毁或调用 setBuffer() 来更改缓冲区之前保持有效。QBuffer 不拥有 QByteArray。

如果你在只写模式或读写模式下打开缓冲区并将内容写入 QBuffer，则 byteArray 将会被修改。

示例

    QByteArray byteArray("abc");
    QBuffer buffer(&byteArray);
    buffer.open(QIODevice::WriteOnly);
    buffer.seek(3);
    buffer.write("def", 3);
    buffer.close();
    // byteArray == "abcdef"

另请参阅: open()、setBuffer() 和 setData()。

[虚析构函数] QBuffer::~QBuffer()

销毁缓冲区。

[重写虚函数] bool QBuffer::atEnd() const

重实现: QIODevice::atEnd() const.

QByteArray &QBuffer::buffer()

返回对 QBuffer 的内部缓冲区的引用。你可以使用它来修改 QByteArray，而不改变 QBuffer。

另请参阅setBuffer() 和 data()。

const QByteArray &QBuffer::buffer() const

这是一个重载函数。

这与 data() 相同。

[覆盖虚函数] bool QBuffer::canReadLine() const

重新实现：QIODevice::canReadLine() const.

[覆盖虚函数] void QBuffer::close()

重新实现：QIODevice::close().

const QByteArray &QBuffer::data() const

返回缓冲区中的数据。

这与 buffer() 相同。

另请参阅setData() 和 setBuffer()。

[覆盖虚函数] bool QBuffer::open(QIODeviceBase::OpenMode flags)

重新实现：QIODevice::open(QIODeviceBase::OpenMode mode).

与QFile不同，以只写模式或读写模式打开一个QBuffer QIODevice::WriteOnly不会截断它。然而，pos()被设置为0。使用QIODevice::Append或QIODevice::Truncate来改变任一行为。

[覆盖虚函数] qint64 QBuffer::pos() const

重新实现：QIODevice::pos() const.

[覆盖虚函数受保护] qint64 QBuffer::readData(char *data, qint64 len)

重新实现：QIODevice::readData(char *data, qint64 maxSize).

[覆盖虚函数] bool QBuffer::seek(qint64 pos)

重新实现：QIODevice::seek(qint64 pos).

void QBuffer::setBuffer(QByteArray *byteArray)

使QBuffer使用由byteArray指向的QByteArray作为其内部缓冲区。调用者负责确保在QBuffer被销毁之前，或者直到调用setBuffer()更改缓冲区之前，byteArray保持有效。QBuffer不会获取QByteArray的所有权。

如果< span class="notranslate">isOpen()是真的，不执行任何操作。

如果你以只写模式或读写模式打开缓冲区并将某物写入QBuffer，则byteArray将被修改。

示例

    QByteArray byteArray("abc");
    QBuffer buffer;
    buffer.setBuffer(&byteArray);
    buffer.open(QIODevice::WriteOnly);
    buffer.seek(3);
    buffer.write("def", 3);
    buffer.close();
    // byteArray == "abcdef"

如果byteArray是nullptr，则缓冲区创建自己的内部QByteArray来完成工作。这个字节数组最初是空的。

另请参阅 buffer()，setData()，以及open（）。

void QBuffer::setData(const QByteArray &data)

将内部缓冲区的内容设置为data。这与将data分配给buffer相同。

如果< span class="notranslate">isOpen()是真的，不执行任何操作。

另请参阅 data（）和setBuffer（）。

void QBuffer::setData(const char *data, qsizetype size)

这是一个重载函数。

将内部缓冲区的内容设置为data的第一个size字节。

[继承虚拟] qint64 QBuffer::size() const

重实现：QIODevice::size() const。

[继承虚拟保护] qint64 QBuffer::writeData(const char *data, qint64 len)

重实现：QIODevice::writeData(const char *data, qint64 maxSize)。