QDataStream Class

Dokumentation zu den Mitgliedsfunktionen

QDataStream::QDataStream()

Erstellt einen Datenstrom ohne E/A-Gerät.

Siehe auch ` setDevice()`.

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

Erstellt einen Datenstrom, der das E/A-Gerät „ d “ verwendet.

Siehe auch setDevice() und device().

QDataStream::QDataStream(const QByteArray &a)

Erstellt einen schreibgeschützten Datenstrom, der mit dem Byte-Array ` a` arbeitet. Verwenden Sie `QDataStream(QByteArray*, int)`, wenn Sie in ein Byte-Array schreiben möchten.

Da QByteArray keine Unterklasse von QIODevice ist, wird intern ein ` QBuffer ` erstellt, um das Byte-Array zu verpacken.

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

Erstellt einen Datenstrom, der auf ein Byte-Array angewendet wird: ` a`. Die Funktion ` mode ` beschreibt, wie das Gerät verwendet werden soll.

Alternativ können Sie `QDataStream(const QByteArray &)` verwenden, wenn Sie lediglich aus einem Byte-Array lesen möchten.

Da ` QByteArray ` keine Unterklasse von ` QIODevice ` ist, wird intern ein ` QBuffer ` erstellt, um das Byte-Array zu verpacken.

[noexcept] QDataStream::~QDataStream()

Löscht den Datenstrom.

Der Destruktor hat keine Auswirkungen auf das aktuelle E/A-Gerät, es sei denn, es handelt sich um ein internes E/A-Gerät (z. B. ein „ QBuffer “), das einen im Konstruktor übergebenen „ 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 nach Verlust der Stream-Synchronisation abzubrechen.

Wird die Funktion bei einer inneren Transaktion aufgerufen, wird der Abbruch an die äußerste Transaktion delegiert, und anschließend gestartete innere Transaktionen werden zwangsweise zum Fehlschlagen gebracht.

Bei der äußersten Transaktion werden der Wiederherstellungspunkt und alle intern duplizierten Daten des Datenstroms verworfen. Die aktuelle Lese-Position des Datenstroms wird dadurch 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 Datenstroms oder der Datei) erreicht hat oder wenn kein E/A-Gerät festgelegt ist; andernfalls wird „ false “ zurückgegeben.

Siehe auch QIODevice::atEnd().

QDataStream::ByteOrder QDataStream::byteOrder() const

Gibt die aktuelle Byte-Reihenfolge-Einstellung 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 wird „ false “ zurückgegeben.

Wird diese Funktion innerhalb einer inneren Transaktion aufgerufen, wird die Festschreibung so lange aufgeschoben, bis der äußerste Aufruf von `commitTransaction()`, ` rollbackTransaction()` oder ` abortTransaction()` erfolgt.

Andernfalls, wenn der Stream-Status anzeigt, dass über das Ende der Daten hinaus gelesen wurde, setzt diese Funktion die Stream-Daten auf den Zeitpunkt des Aufrufs von ` startTransaction()` zurück. Tritt diese Situation ein, müssen Sie warten, bis weitere Daten eintreffen; anschließend starten Sie eine neue Transaktion. 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 “, falls derzeit kein Gerät eingestellt ist.

Siehe auch setDevice().

QDataStream::FloatingPointPrecision QDataStream::floatingPointPrecision() const

Gibt die Gleitkommagenauigkeit 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 eine Referenz auf den Stream zurück.

Der Puffer „ s “ wird mit „ new [] “ zugewiesen. Löschen Sie ihn mit dem Operator „ delete [] “.

Der Parameter ` l ` wird auf die Länge des Puffers gesetzt. Ist die gelesene Zeichenkette leer, wird ` l ` auf 0 und ` s ` auf ` nullptr` gesetzt.

Das Serialisierungsformat besteht zunächst aus einem Längenangabe-Spekifikator, gefolgt von l Bytes an Daten. Der Längenbezeichner 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 Erweiterungswert 0xfffffffe, gefolgt von einem „quint64“ mit dem tatsächlichen Wert. Bei Containern, die isNull() unterstützen, wird dieser Wert zudem als einzelnes „quint32“ mit gesetzten Bits und ohne Daten kodiert.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch readRawData() und writeBytes().

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

Liest höchstens len Bytes aus dem Stream in s und gibt die Anzahl der gelesenen Bytes zurück. Tritt ein Fehler auf, gibt diese Funktion -1 zurück.

Der Puffer ` s ` muss vorab reserviert sein. 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 üblicherweise verwendet, um die Transaktion zurückzusetzen, wenn vor dem Commit der Transaktion ein unvollständiger Lesevorgang festgestellt wurde.

Wird die Funktion in einer inneren Transaktion aufgerufen, wird das Zurücksetzen an die äußerste Transaktion delegiert, und anschließend gestartete innere Transaktionen werden zwangsweise abgebrochen.

Für die äußerste Transaktion werden die Stream-Daten auf den Zeitpunkt des Aufrufs von ` startTransaction()` zurückgesetzt. Wenn der Datenstrom beschädigte Daten gelesen hat oder eine der inneren Transaktionen abgebrochen wurde, bricht diese Funktion die Transaktion ab.

Waren die vorangegangenen Stream-Operationen erfolgreich, wird der Status des Datenstroms auf

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

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

Legt die Byte-Reihenfolge bei der Serialisierung auf „ bo “ fest.

Der Parameter „ bo “ kann folgende Werte annehmen: „ QDataStream::BigEndian “ oder „ QDataStream::LittleEndian “.

Die Standardeinstellung ist „big-endian“. Wir empfehlen, diese Einstellung beizubehalten, sofern Sie keine besonderen Anforderungen haben.

Siehe auch byteOrder().

void QDataStream::setDevice(QIODevice *d)

void QDataStream::setDevice(QIODevice * d)

Setzt das E/A-Gerät auf ` d`. Mit ` nullptr ` kann die Zuordnung zum aktuellen E/A-Gerät aufgehoben werden.

Siehe auch device().

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

Legt die Gleitkommagenauigkeit des Datenstroms auf „ precision “ fest. Wenn die Gleitkommagenauigkeit „ DoublePrecision “ lautet und die Version des Datenstroms „ Qt_4_6 “ oder höher ist, werden alle Gleitkommazahlen mit 64-Bit-Genauigkeit geschrieben und gelesen. Wenn die Gleitkommagenauigkeit „ SinglePrecision “ beträgt und die Version „ Qt_4_6 “ oder höher ist, werden alle Gleitkommazahlen mit 32-Bit-Genauigkeit geschrieben und gelesen.

Bei Versionen vor Qt_4_6 hängt die Genauigkeit der Gleitkommazahlen im Datenstrom vom aufgerufenen Stream-Operator ab.

Die Standardeinstellung 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 den angegebenen „ 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 Datenserialisierungsformats auf „ v “, einen Wert aus der Enumeration „ Version “.

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

Um neuen Funktionen Rechnung zu tragen, hat sich das Datenstrom-Serialisierungsformat einiger Qt-Klassen in bestimmten Qt-Versionen geändert. Wenn du Daten lesen möchtest, die mit einer früheren Qt-Version erstellt wurden, oder Daten schreiben möchtest, die von einem Programm gelesen werden können, das mit einer früheren Qt-Version kompiliert wurde, verwende diese Funktion, um das von ` QDataStream` verwendete Serialisierungsformat anzupassen.

Die Enumeration ` Version ` stellt symbolische Konstanten für die verschiedenen Qt-Versionen bereit. 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 im Fehlerfall.

Dies entspricht 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 Lese-Transaktion im Stream.

Definiert einen wiederherstellbaren Punkt innerhalb der Abfolge von Lesevorgängen. Bei sequenziellen Geräten werden die Lesedaten intern dupliziert, um im Falle unvollständiger Lesevorgänge eine Wiederherstellung 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, führen nachfolgende Aufrufe dieser Funktion dazu, dass die Transaktion rekursiv wird. Innere Transaktionen agieren als Vertreter der äußersten Transaktion (d. h., sie melden den Status von Lesevorgängen an die äußerste Transaktion, die die Position des Datenstroms wiederherstellen kann).

Tritt während einer Transaktion ein Fehler auf (einschließlich des Fehlschlags einer inneren Transaktion), wird das Lesen aus dem Datenstrom unterbrochen (alle nachfolgenden Lesevorgänge geben leere/Null-Werte zurück) und nachfolgende innere Transaktionen werden zwangsweise zum Fehlschlagen gebracht. Das Starten einer neuen äußersten Transaktion stellt diesen Zustand wieder her. Durch dieses Verhalten ist es nicht erforderlich, jeden Lesevorgang separat auf Fehler zu prü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 Datenserialisierungsformats 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 eine Referenz auf den Stream zurück.

Der Wert „ len “ wird als „quint32“ und optional als „quint64“ serialisiert, gefolgt von „ len “ Bytes aus „ s “. Beachten Sie, dass die Daten nicht kodiert werden.

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 im Fehlerfall. Die Daten werden nicht kodiert.

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

[explicit noexcept, since 6.10] QDataStream::operator bool() const

Gibt zurück, ob dieser Stream fehlerfrei ist (status() gibt „ Ok “ zurück).

Diese Funktion wurde in Qt 6.10 eingeführt.

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

Schreibt ein vorzeichenbehaftetes Byte ( i) in den Stream und gibt eine Referenz auf den Stream zurück.

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

Schreibt einen booleschen Wert ( i) in den Stream. Gibt eine Referenz auf den Stream zurück.

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

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)

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)

Schreibt die durch „\0 “ begrenzte Zeichenkette „ s “ in den Stream und gibt eine Referenz auf den Stream zurück.

Die Zeichenkette wird mithilfe von ` writeBytes()` serialisiert.

Siehe auch writeBytes() und writeRawData().

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

Schreibt eine Gleitkommazahl, f, im Standardformat IEEE 754 in den Stream. Gibt eine Referenz auf den Stream zurück.

Siehe auch ` setFloatingPointPrecision()`.

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

Schreibt eine Gleitkommazahl, f, im Standardformat IEEE 754 in den Stream. Gibt eine Referenz auf den Stream zurück.

Siehe auch ` setFloatingPointPrecision()`.

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

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

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

Schreibt eine vorzeichenbehaftete 32-Bit-Ganzzahl ( i) in den Stream und gibt eine Referenz auf den Stream zurück.

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

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

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

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

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

Schreibt eine vorzeichenlose Ganzzahl, i, als 32-Bit-Ganzzahl ohne Vorzeichen (quint32) in den Stream. Gibt eine Referenz auf den Stream zurück.

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

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

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

Schreibt ein vorzeichenloses Byte ( i) in den Stream und gibt eine Referenz auf den Stream zurück.

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

Simuliert das Schreiben eines std::nullptr_t( ptr) in den Stream und gibt eine Referenz auf den Stream zurück. Diese Funktion schreibt tatsächlich nichts in den Stream, da std::nullptr_t -Werte als 0 Byte gespeichert werden.

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

Liest einen booleschen Wert aus dem Stream in ` i` ein. Gibt eine Referenz auf den Stream zurück.

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

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

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

Liest die Zeichenkette s aus dem Stream und gibt eine Referenz auf den Stream zurück.

Die Zeichenkette wird mit readBytes() deserialisiert, wobei das Serialisierungsformat zunächst aus einem Längenangabe- quint32 besteht, gefolgt von entsprechend vielen Datenbytes. Die resultierende Zeichenkette endet immer mit „\0 “.

Der Speicherplatz für die Zeichenkette wird mit ` new [] ` zugewiesen – der Aufrufer muss ihn mit ` delete []` freigeben.

Siehe auch readBytes() und readRawData().

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

Liest ein 16-Bit-Zeichen aus dem Stream in ` c ` ein 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)

Liest ein 32-Bit-Zeichen aus dem Stream in ` c ` ein und gibt eine Referenz auf den Stream zurück.

Diese Funktion wurde in Qt 6.0 eingeführt.

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

Liest eine Gleitkommazahl aus dem Stream in ` f` unter Verwendung des Standardformats IEEE 754 ein. Gibt eine Referenz auf den Stream zurück.

Siehe auch ` setFloatingPointPrecision()`.

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

Liest eine Gleitkommazahl aus dem Stream in ` f` unter Verwendung des Standardformats IEEE 754 ein. Gibt eine Referenz auf den Stream zurück.

Siehe auch ` setFloatingPointPrecision()`.

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

Liest eine vorzeichenbehaftete 16-Bit-Ganzzahl aus dem Stream in ` i` ein und gibt eine Referenz auf den Stream zurück.

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

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

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

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

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

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

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

Liest eine vorzeichenlose 32-Bit-Ganzzahl aus dem Stream in ` i` ein und gibt eine Referenz auf den Stream zurück.

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

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

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

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

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

Simuliert das Einlesen eines „ std::nullptr_t “ aus dem Stream in „ ptr “ und gibt eine Referenz auf den Stream zurück. Diese Funktion liest tatsächlich nichts aus dem Stream ein, da „ std::nullptr_t “-Werte als 0 Byte gespeichert werden.