QBuffer Class

成员函数文档

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

使用给定的parent 构建一个空缓冲区。您可以调用setData()向缓冲区中写入数据，或者以写入模式打开该缓冲区并使用write()。

另请参阅 open()。

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

构建一个QBuffer，该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 标志打开缓冲区，成功时返回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 正数）。

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() 为真，则不执行任何操作。

另请参见 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）。