QBuffer Class

成员函数文档

[explicit] QBuffer::QBuffer(QObject *parent = nullptr)

用给定的parent 构建一个空缓冲区。您可以调用setData() 将数据填入缓冲区，也可以在写模式下打开缓冲区并使用write() 。

另请参阅 open() 。

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

构造一个 QBuffer，使用byteArray 指向的QByteArray 作为内部缓冲区，并使用给定的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().

[virtual noexcept] QBuffer::~QBuffer()

销毁缓冲区。

[override virtual] bool QBuffer::atEnd() const

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

QByteArray &QBuffer::buffer()

返回QBuffer 内部缓冲区的引用。您可以用它在QBuffer 的背后修改QByteArray 。

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

const QByteArray &QBuffer::buffer() const

这是一个重载函数。

它与data() 相同。

[override virtual] bool QBuffer::canReadLine() const

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

[override virtual] void QBuffer::close()

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

const QByteArray &QBuffer::data() const

返回缓冲区中的数据。

这与buffer() 相同。

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

[override virtual] bool QBuffer::open(QIODeviceBase::OpenMode mode)

重实现：QIODevice::open(QIODeviceBase::OpenMode mode）。

使用mode 标志打开缓冲区，如果成功则返回true ，否则返回false 。

mode 的标志必须包括QIODeviceBase::ReadOnly,WriteOnly, 或ReadWrite 。如果不包括，则打印错误信息，方法失败。在其他任何情况下，该方法都会成功。

与QFile::open() 不同，使用WriteOnly 打开QBuffer 不会截断它。不过，pos() 会被设置为0 。使用Append 或Truncate 可以改变这两种行为。

[override virtual] qint64 QBuffer::pos() const

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

[override virtual protected] qint64 QBuffer::readData(char *data, qint64 len)

重实现：QIODevice::readData(char *data, qint64 maxSize）。

[override virtual] bool QBuffer::seek(qint64 pos)

重实现：QIODevice::seek(qint64 pos)。

void QBuffer::setBuffer(QByteArray *byteArray)

使QBuffer 使用byteArray 指向的QByteArray 作为内部缓冲区。调用者有责任确保byteArray 一直有效，直到QBuffer 被销毁，或调用 setBuffer() 更改缓冲区。QBuffer 不会占用QByteArray 的所有权。

如果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() 相同。

如果isOpen() 为 true，则不执行任何操作。

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

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

这是一个重载函数。

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

[override virtual] qint64 QBuffer::size() const

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

[override virtual protected] qint64 QBuffer::writeData(const char *data, qint64 len)

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