QDataStream Class

Dokumentation der Mitgliedsfunktionen

QDataStream::QDataStream()

Konstruiert einen Datenstrom, der kein E/A-Gerät hat.

Siehe auch setDevice().

[explicit] QDataStream::QDataStream(QIODevice *d)

Konstruiert einen Datenstrom, der das E/A-Gerät d verwendet.

Siehe auch setDevice() und device().

QDataStream::QDataStream(const QByteArray &a)

Konstruiert einen Nur-Lese-Datenstrom, der mit dem Byte-Array a arbeitet. Verwenden Sie QDataStream(QByteArray*, int), wenn Sie in ein Byte-Array schreiben wollen.

Da QByteArray keine QIODevice Unterklasse ist, wird intern ein QBuffer erstellt, um das Byte-Array zu umhüllen.

QDataStream::QDataStream(QByteArray *a, QIODeviceBase::OpenMode mode)

Konstruiert einen Datenstrom, der auf einem Byte-Array arbeitet, a. Die mode beschreibt, wie das Gerät verwendet werden soll.

Alternativ können Sie QDataStream(const QByteArray &) verwenden, wenn Sie nur von einem Byte-Array lesen wollen.

Da QByteArray keine QIODevice Unterklasse ist, wird intern ein QBuffer erstellt, um das Byte-Array zu umhüllen.

[noexcept] QDataStream::~QDataStream()

Zerstört den Datenstrom.

Der Destruktor wirkt sich nicht auf das aktuelle E/A-Gerät aus, es sei denn, es handelt sich um ein internes E/A-Gerät (z. B. QBuffer), das ein im Konstruktor übergebenes QByteArray verarbeitet; in diesem Fall wird das interne E/A-Gerät zerstört.

void QDataStream::abortTransaction()

Bricht eine Lesetransaktion ab.

Diese Funktion wird üblicherweise verwendet, um die Transaktion nach Protokollfehlern auf höherer Ebene oder dem Verlust der Stream-Synchronisation abzubrechen.

Wird sie bei einer inneren Transaktion aufgerufen, wird der Abbruch an die äußerste Transaktion delegiert, und anschließend gestartete innere Transaktionen werden zum Scheitern gezwungen.

Für die äußerste Transaktion werden der Wiederherstellungspunkt und alle intern duplizierten Daten des Streams verworfen. Die aktuelle Leseposition des Streams wird nicht beeinflusst.

Setzt den Status des Datenstroms auf

Siehe auch startTransaction(), commitTransaction(), und rollbackTransaction().

bool QDataStream::atEnd() const

Gibt true zurück, wenn das E/A-Gerät die Endposition (Ende des Streams oder der Datei) erreicht hat oder wenn kein E/A-Gerät eingestellt ist; andernfalls wird false zurückgegeben.

Siehe auch QIODevice::atEnd().

QDataStream::ByteOrder QDataStream::byteOrder() const

Gibt die aktuelle Einstellung der Byte-Reihenfolge zurück - entweder BigEndian oder LittleEndian.

Siehe auch setByteOrder().

bool QDataStream::commitTransaction()

Schließt eine Lesetransaktion ab. Gibt true zurück, wenn während der Transaktion keine Lesefehler aufgetreten sind; andernfalls false.

Wird die Funktion bei einer inneren Transaktion aufgerufen, wird die Übertragung verschoben, bis der äußerste Aufruf von commitTransaction(), rollbackTransaction() oder abortTransaction() erfolgt.

Andernfalls, wenn der Stream-Status anzeigt, dass das Lesen über das Ende der Daten hinausgeht, stellt diese Funktion die Stream-Daten an dem Punkt des startTransaction()-Aufrufs wieder her. In diesem Fall müssen Sie warten, bis weitere Daten eintreffen, und dann eine neue Transaktion starten. Wenn der Datenstrom beschädigte Daten gelesen hat oder eine der inneren Transaktionen abgebrochen wurde, bricht diese Funktion die Transaktion ab.

Siehe auch startTransaction(), rollbackTransaction(), und abortTransaction().

QIODevice *QDataStream::device() const

Gibt das aktuell eingestellte E/A-Gerät zurück, oder nullptr, wenn kein Gerät eingestellt ist.

Siehe auch setDevice().

QDataStream::FloatingPointPrecision QDataStream::floatingPointPrecision() const

Gibt die Fließkommagenauigkeit des Datenstroms zurück.

Siehe auch FloatingPointPrecision und setFloatingPointPrecision().

[since 6.7] QDataStream &QDataStream::readBytes(char *&s, qint64 &l)

Liest den Puffer s aus dem Stream und gibt einen Verweis auf den Stream zurück.

Der Puffer s wird mit new [] zugewiesen. Zerstören Sie ihn mit dem Operator delete [].

Der Parameter l wird auf die Länge des Puffers gesetzt. Wenn der gelesene String leer ist, wird l auf 0 und s auf nullptr gesetzt.

Das Serialisierungsformat ist zuerst ein Längenbezeichner, dann l Bytes der Daten. Der Längenspezifizierer ist ein quint32, wenn die Version kleiner als 6.7 ist oder wenn die Anzahl der Elemente kleiner als 0xfffffffe (2^32 -2) ist, andernfalls gibt es einen erweiterten Wert 0xfffffffe, gefolgt von einem quint64 mit dem aktuellen Wert. Bei Containern, die isNull() unterstützen, wird er zusätzlich als ein einzelner quint32 mit allen gesetzten Bits und ohne Daten kodiert.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch readRawData() und writeBytes().

[until 6.11] QDataStream &QDataStream::readBytes(char *&s, uint &l)

Diese Funktion soll in Version 6.11 veraltet sein.

Verwenden Sie stattdessen eine Überladung, die qint64 length annimmt.

qint64 QDataStream::readRawData(char *s, qint64 len)

Liest maximal len Bytes aus dem Stream in s und gibt die Anzahl der gelesenen Bytes zurück. Wenn ein Fehler auftritt, gibt diese Funktion -1 zurück.

Der Puffer s muss vorab zugewiesen werden. Die Daten werden nicht dekodiert.

Siehe auch readBytes(), QIODevice::read(), und writeRawData().

void QDataStream::resetStatus()

Setzt den Status des Datenstroms zurück.

Siehe auch Status, status(), und setStatus().

void QDataStream::rollbackTransaction()

Macht eine Lesetransaktion rückgängig.

Diese Funktion wird in der Regel verwendet, um die Transaktion zurückzusetzen, wenn vor dem Commit der Transaktion ein unvollständiger Lesevorgang festgestellt wurde.

Wird sie bei einer inneren Transaktion aufgerufen, wird die Rückgängigmachung an die äußerste Transaktion delegiert, und anschließend gestartete innere Transaktionen werden zum Scheitern gezwungen.

Bei der äußersten Transaktion werden die Daten des Datenstroms an dem Punkt wiederhergestellt, an dem der Aufruf startTransaction() erfolgte. Wenn der Datenstrom beschädigte Daten gelesen hat oder eine der inneren Transaktionen abgebrochen wurde, bricht diese Funktion die Transaktion ab.

Wenn die vorangegangenen Stream-Operationen erfolgreich waren, setzt sie den Status des Datenstroms auf

Siehe auch startTransaction(), commitTransaction(), und abortTransaction().

void QDataStream::setByteOrder(QDataStream::ByteOrder bo)

Setzt die Byte-Reihenfolge der Serialisierung auf bo.

Der Parameter bo kann QDataStream::BigEndian oder QDataStream::LittleEndian sein.

Die Standardeinstellung ist Big-Endian. Wir empfehlen, diese Einstellung beizubehalten, es sei denn, Sie haben besondere Anforderungen.

Siehe auch byteOrder().

void QDataStream::setDevice(QIODevice *d)

void QDataStream::setDevice(QIODevice *d)

Setzt das E/A-Gerät auf d, das mit nullptr auf das aktuelle E/A-Gerät zurückgesetzt werden kann.

Siehe auch device().

void QDataStream::setFloatingPointPrecision(QDataStream::FloatingPointPrecision precision)

Setzt die Fließkomma-Präzision des Datenstroms auf precision. Wenn die Fließkomma-Präzision DoublePrecision und die Version des Datenstroms Qt_4_6 oder höher ist, werden alle Fließkommazahlen mit 64-Bit-Präzision geschrieben und gelesen. Ist die Fließkommagenauigkeit SinglePrecision und die Version Qt_4_6 oder höher, werden alle Fließkommazahlen mit 32-Bit-Genauigkeit geschrieben und gelesen.

Bei Versionen vor Qt_4_6 hängt die Genauigkeit der Fließkommazahlen im Datenstrom von dem aufgerufenen Stream-Operator ab.

Die Voreinstellung ist DoublePrecision.

Beachten Sie, dass diese Eigenschaft keinen Einfluss auf die Serialisierung oder Deserialisierung von qfloat16 Instanzen hat.

Siehe auch floatingPointPrecision().

void QDataStream::setStatus(QDataStream::Status status)

Setzt den Status des Datenstroms auf die angegebene status.

Nachfolgende Aufrufe von setStatus() werden ignoriert, bis resetStatus() aufgerufen wird.

Siehe auch Status, status(), und resetStatus().

void QDataStream::setVersion(int v)

Setzt die Versionsnummer des Daten-Serialisierungsformats auf v, einen Wert aus dem Version enum.

Sie müssen keine Version setzen, wenn Sie die aktuelle Version von Qt verwenden, aber für Ihre eigenen benutzerdefinierten Binärformate empfehlen wir Ihnen, dies zu tun; siehe Versioning in der detaillierten Beschreibung.

Um neue Funktionen unterzubringen, hat sich das Format der Serialisierung von Datenströmen einiger Qt-Klassen in einigen Versionen von Qt geändert. Wenn Sie Daten lesen wollen, die von einer früheren Version von Qt erstellt wurden, oder Daten schreiben wollen, die von einem Programm gelesen werden können, das mit einer früheren Version von Qt kompiliert wurde, verwenden Sie diese Funktion, um das von QDataStream verwendete Serialisierungsformat zu ändern.

Das Version enum bietet symbolische Konstanten für die verschiedenen Versionen von Qt. Zum Beispiel:

QDataStream out(file);
out.setVersion(QDataStream::Qt_4_0);

Siehe auch version() und Version.

qint64 QDataStream::skipRawData(qint64 len)

Überspringt len Bytes vom Gerät. Gibt die Anzahl der tatsächlich übersprungenen Bytes zurück, oder -1 bei einem Fehler.

Dies ist gleichbedeutend mit dem Aufruf von readRawData() für einen Puffer der Länge len und dem Ignorieren des Puffers.

Siehe auch QIODevice::seek().

void QDataStream::startTransaction()

Startet eine neue Lesetransaktion auf dem Stream.

Definiert einen wiederherstellbaren Punkt innerhalb der Sequenz von Lesevorgängen. Bei sequentiellen Geräten werden die gelesenen Daten intern dupliziert, um eine Wiederherstellung im Falle unvollständiger Lesevorgänge zu ermöglichen. Bei Geräten mit wahlfreiem Zugriff speichert diese Funktion die aktuelle Position des Streams. Rufen Sie commitTransaction(), rollbackTransaction(), oder abortTransaction() auf, um die aktuelle Transaktion zu beenden.

Sobald eine Transaktion gestartet wurde, wird die Transaktion durch nachfolgende Aufrufe dieser Funktion rekursiv. Innere Transaktionen fungieren als Agenten der äußersten Transaktion (d. h. sie melden den Status von Leseoperationen an die äußerste Transaktion, die die Position des Streams wiederherstellen kann).

Wenn während einer Transaktion ein Fehler auftritt (einschließlich einer fehlgeschlagenen inneren Transaktion), wird das Lesen aus dem Datenstrom unterbrochen (alle nachfolgenden Leseoperationen geben leere/keine Werte zurück) und nachfolgende innere Transaktionen werden zum Fehlschlagen gezwungen. Durch den Start einer neuen, äußersten Transaktion wird dieser Zustand wiederhergestellt. Dieses Verhalten macht es unnötig, jeden Lesevorgang einzeln auf Fehler zu überprüfen.

Siehe auch commitTransaction(), rollbackTransaction(), und abortTransaction().

QDataStream::Status QDataStream::status() const

Gibt den Status des Datenstroms zurück.

Siehe auch Status, setStatus(), und resetStatus().

int QDataStream::version() const

Gibt die Versionsnummer des Daten-Serialisierungsformats zurück.

Siehe auch setVersion() und Version.

QDataStream &QDataStream::writeBytes(const char *s, qint64 len)

Schreibt den Längenbezeichner len und den Puffer s in den Stream und gibt einen Verweis auf den Stream zurück.

len wird als quint32 und ein optionales quint64 serialisiert, gefolgt von len Bytes von s. Beachten Sie, dass die Daten nicht kodiert sind.

Siehe auch writeRawData() und readBytes().

qint64 QDataStream::writeRawData(const char *s, qint64 len)

Schreibt len Bytes von s in den Stream. Gibt die Anzahl der tatsächlich geschriebenen Bytes zurück, oder -1 bei einem Fehler. Die Daten werden nicht kodiert.

Siehe auch writeBytes(), QIODevice::write(), und readRawData().

QDataStream &QDataStream::operator<<(qint8 i)

Schreibt ein vorzeichenbehaftetes Byte, i, in den Stream und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator<<(bool i)

Dies ist eine überladene Funktion.

Schreibt einen booleschen Wert, i, in den Stream. Gibt einen Verweis auf den Stream zurück.

[since 6.0] QDataStream &QDataStream::operator<<(char16_t c)

Dies ist eine überladene Funktion.

Schreibt ein Zeichen, c, in den Stream. Gibt eine Referenz auf den Stream zurück

Diese Funktion wurde in Qt 6.0 eingeführt.

[since 6.0] QDataStream &QDataStream::operator<<(char32_t c)

Dies ist eine überladene Funktion.

Schreibt ein Zeichen, c, in den Stream. Gibt eine Referenz auf den Stream zurück

Diese Funktion wurde in Qt 6.0 eingeführt.

QDataStream &QDataStream::operator<<(const char *s)

Dies ist eine überladene Funktion.

Schreibt die '\0'-terminierte Zeichenkette s in den Stream und gibt eine Referenz auf den Stream zurück.

Die Zeichenkette wird mit writeBytes() serialisiert.

Siehe auch writeBytes() und writeRawData().

QDataStream &QDataStream::operator<<(double f)

Dies ist eine überladene Funktion.

Schreibt eine Fließkommazahl, f, in den Stream unter Verwendung des Standardformats IEEE 754. Gibt einen Verweis auf den Stream zurück.

Siehe auch setFloatingPointPrecision().

QDataStream &QDataStream::operator<<(float f)

Dies ist eine überladene Funktion.

Schreibt eine Fließkommazahl, f, in den Stream unter Verwendung des Standardformats IEEE 754. Gibt einen Verweis auf den Stream zurück.

Siehe auch setFloatingPointPrecision().

QDataStream &QDataStream::operator<<(qint16 i)

Dies ist eine überladene Funktion.

Schreibt eine vorzeichenbehaftete 16-Bit-Ganzzahl, i, in den Stream und gibt eine Referenz auf den Stream zurück.

QDataStream &QDataStream::operator<<(qint32 i)

Dies ist eine überladene Funktion.

Schreibt eine vorzeichenbehaftete 32-Bit-Ganzzahl, i, in den Stream und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator<<(qint64 i)

Dies ist eine überladene Funktion.

Schreibt eine vorzeichenbehaftete 64-Bit-Ganzzahl, i, in den Stream und gibt eine Referenz auf den Stream zurück.

QDataStream &QDataStream::operator<<(quint16 i)

Dies ist eine überladene Funktion.

Schreibt eine vorzeichenlose 16-Bit-Ganzzahl, i, in den Stream und gibt eine Referenz auf den Stream zurück.

QDataStream &QDataStream::operator<<(quint32 i)

Dies ist eine überladene Funktion.

Schreibt eine ganze Zahl ohne Vorzeichen, i, als 32-Bit-Ganzzahl ohne Vorzeichen (quint32) in den Stream. Gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator<<(quint64 i)

Dies ist eine überladene Funktion.

Schreibt eine vorzeichenlose 64-Bit-Ganzzahl, i, in den Stream und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator<<(quint8 i)

Dies ist eine überladene Funktion.

Schreibt ein Byte ohne Vorzeichen, i, in den Stream und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator<<(std::nullptr_t ptr)

Dies ist eine überladene Funktion.

Simuliert das Schreiben eines std::nullptr_t, ptr, in den Stream und gibt einen Verweis auf den Stream zurück. Diese Funktion schreibt tatsächlich nichts in den Stream, da die Werte von std::nullptr_t als 0 Bytes gespeichert werden.

QDataStream &QDataStream::operator>>(bool &i)

Liest einen booleschen Wert aus dem Stream in i. Gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator>>(qint8 &i)

Liest ein vorzeichenbehaftetes Byte aus dem Stream in i und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator>>(char *&s)

Dies ist eine überladene Funktion.

Liest die Zeichenkette s aus dem Stream und gibt einen Verweis auf den Stream zurück.

Die Zeichenkette wird unter Verwendung von readBytes() deserialisiert, wobei das Serialisierungsformat zuerst einen quint32 Längenspezifizierer enthält, gefolgt von so vielen Datenbytes. Die resultierende Zeichenkette ist immer '\0'-terminiert.

Der Platz für die Zeichenkette wird mit new [] zugewiesen - der Aufrufer muss ihn mit delete [] zerstören.

Siehe auch readBytes() und readRawData().

[since 6.0] QDataStream &QDataStream::operator>>(char16_t &c)

Dies ist eine überladene Funktion.

Liest ein 16bit breites Zeichen aus dem Stream in c und gibt eine Referenz auf den Stream zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

[since 6.0] QDataStream &QDataStream::operator>>(char32_t &c)

Dies ist eine überladene Funktion.

Liest ein 32bit breites Zeichen aus dem Stream in c und gibt eine Referenz auf den Stream zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

QDataStream &QDataStream::operator>>(double &f)

Dies ist eine überladene Funktion.

Liest eine Fließkommazahl aus dem Stream in f, wobei das Standardformat IEEE 754 verwendet wird. Gibt einen Verweis auf den Stream zurück.

Siehe auch setFloatingPointPrecision().

QDataStream &QDataStream::operator>>(float &f)

Dies ist eine überladene Funktion.

Liest eine Fließkommazahl aus dem Stream in f, wobei das Standardformat IEEE 754 verwendet wird. Gibt einen Verweis auf den Stream zurück.

Siehe auch setFloatingPointPrecision().

QDataStream &QDataStream::operator>>(qint16 &i)

Dies ist eine überladene Funktion.

Liest eine 16-Bit-Ganzzahl mit Vorzeichen aus dem Stream in i und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator>>(qint32 &i)

Dies ist eine überladene Funktion.

Liest eine vorzeichenbehaftete 32-Bit-Ganzzahl aus dem Stream in i und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator>>(qint64 &i)

Dies ist eine überladene Funktion.

Liest eine vorzeichenbehaftete 64-Bit-Ganzzahl aus dem Stream in i und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator>>(quint16 &i)

Dies ist eine überladene Funktion.

Liest eine vorzeichenlose 16-Bit-Ganzzahl aus dem Stream in i und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator>>(quint32 &i)

Dies ist eine überladene Funktion.

Liest eine 32-Bit-Ganzzahl ohne Vorzeichen aus dem Stream in i und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator>>(quint64 &i)

Dies ist eine überladene Funktion.

Liest eine vorzeichenlose 64-Bit-Ganzzahl aus dem Stream in i und gibt einen Verweis auf den Stream zurück.

QDataStream &QDataStream::operator>>(quint8 &i)

Dies ist eine überladene Funktion.

Liest ein Byte ohne Vorzeichen aus dem Stream in i und gibt eine Referenz auf den Stream zurück.

QDataStream &QDataStream::operator>>(std::nullptr_t &ptr)

Dies ist eine überladene Funktion.

Simuliert das Lesen eines std::nullptr_t aus dem Stream in ptr und gibt einen Verweis auf den Stream zurück. Diese Funktion liest nicht wirklich etwas aus dem Stream, da std::nullptr_t Werte als 0 Bytes gespeichert werden.