QBuffer Class

Dokumentation zu den Member-Funktionen

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

Erstellt einen leeren Puffer mit dem angegebenen ` parent`. Sie können die Funktion ` setData()` aufrufen, um den Puffer mit Daten zu füllen, oder Sie können ihn im Schreibmodus öffnen und die Funktion ` write()` verwenden.

Siehe auch open().

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

Erstellt einen QBuffer, der den von byteArray angegebenen QByteArray als internen Puffer verwendet und die angegebene parent enthält. Der Aufrufer muss sicherstellen, dass byteArray gültig bleibt, bis der QBuffer zerstört wird oder bis setBuffer() aufgerufen wird, um den Puffer zu ändern. QBuffer übernimmt nicht die Eigentumsrechte an QByteArray.

Wenn Sie den Puffer im Schreibschutzmodus oder im Lese-Schreib-Modus öffnen und etwas in den QBuffer schreiben, wird „ byteArray “ geändert.

Beispiel:

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

Siehe auch open(), setBuffer() und setData().

[virtual noexcept] QBuffer::~QBuffer()

Löscht den Puffer.

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

Implementiert erneut: ` QIODevice::atEnd()` const.

QByteArray &QBuffer::buffer()

Gibt eine Referenz auf den internen Puffer des „ QBuffer “ zurück. Damit können Sie die „ QByteArray “ hinter dem Rücken des „ QBuffer “ ändern.

Siehe auch setBuffer() und data().

const QByteArray &QBuffer::buffer() const

Dies entspricht „ data()“.

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

Implementiert: ` QIODevice::canReadLine()` const.

[override virtual] void QBuffer::close()

Implementiert: QIODevice::close().

const QByteArray &QBuffer::data() const

Gibt die im Puffer enthaltenen Daten zurück.

Dies entspricht der Funktion „ buffer()“.

Siehe auch „ setData()“ und „ setBuffer()“.

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

Implementiert: QIODevice::open(QIODeviceBase::OpenMode-Modus).

Öffnet den Puffer unter Verwendung der Flags „ mode “ und gibt bei Erfolg „ true “ zurück; andernfalls wird „ false “ zurückgegeben.

Die Flags für „ mode “ müssen „ QIODeviceBase::ReadOnly “, „ WriteOnly “ oder „ ReadWrite “ enthalten. Ist dies nicht der Fall, wird eine Fehlermeldung ausgegeben und die Methode schlägt fehl. In allen anderen Fällen ist die Methode erfolgreich.

Im Gegensatz zu ` QFile::open()` wird ein ` QBuffer ` beim Öffnen mit ` WriteOnly ` nicht gekürzt. Allerdings wird ` pos()` auf ` 0` gesetzt. Verwenden Sie ` Append ` oder ` Truncate `, um eines der beiden Verhaltensweisen zu ändern.

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

Implementiert: ` QIODevice::pos()` const.

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

Implementiert: QIODevice::readData(char *data, qint64 maxSize).

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

Implementiert: QIODevice::seek(qint64 pos).

void QBuffer::setBuffer(QByteArray *byteArray)

Stellt sicher, dass „ QBuffer “ den unter „ byteArray “ angegebenen „ QByteArray “ als internen Puffer verwendet. Der Aufrufer muss sicherstellen, dass „ byteArray “ gültig bleibt, bis „ QBuffer “ zerstört wird oder bis „setBuffer()“ aufgerufen wird, um den Puffer zu ändern. „ QBuffer “ übernimmt keine Eigentumsrechte an „ QByteArray “.

Führt keine Aktion aus, wenn „ isOpen()“ wahr ist.

Wenn Sie den Puffer im Schreibschutzmodus oder im Lese-/Schreibmodus öffnen und etwas in den „ QBuffer “ schreiben, wird „ byteArray “ geändert.

Beispiel:

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

Wenn ` byteArray ` den Wert ` nullptr` hat, erstellt der Puffer sein eigenes internes ` QByteArray `, mit dem er arbeitet. Dieses Byte-Array ist anfangs leer.

Siehe auch buffer(), setData() und open().

void QBuffer::setData(const QByteArray &data)

Setzt den Inhalt des internen Puffers auf „ data “. Dies entspricht der Zuweisung von „ data “ an „ buffer()“.

Führt keine Aktion aus, wenn isOpen() wahr ist.

Siehe auch data() und setBuffer().

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

Setzt den Inhalt des internen Puffers auf die ersten size Bytes von data.

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

Implementiert erneut: ` QIODevice::size()` const.

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

Implementiert: ` QIODevice::writeData` (const char *data, qint64 maxSize).