# QDataStream Class Reference ## [[QtCore](index.htm) module] 該QDataStream類提供的二進制數據序列化到一個[QIODevice](qiodevice.html)。[More...](#details) ### Types * `enum ByteOrder { BigEndian, LittleEndian }` * `enum FloatingPointPrecision { SinglePrecision, DoublePrecision }` * `enum Status { Ok, ReadPastEnd, ReadCorruptData, WriteFailed }` * `enum Version { Qt_1_0, Qt_2_0, Qt_2_1, Qt_3_0, ..., Qt_4_8 }` ### Methods * `__init__ (self)` * `__init__ (self, QIODevice)` * `__init__ (self, QByteArray, QIODevice.OpenMode?flags)` * `__init__ (self, QByteArray)` * `bool atEnd (self)` * `ByteOrder byteOrder (self)` * `QIODevice device (self)` * `FloatingPointPrecision floatingPointPrecision (self)` * `bool readBool (self)` * `str readBytes (self)` * `float readDouble (self)` * `float readFloat (self)` * `int readInt (self)` * `int readInt16 (self)` * `int readInt32 (self)` * `int readInt64 (self)` * `str readInt8 (self)` * `QString readQString (self)` * `QStringList readQStringList (self)` * `QVariant readQVariant (self)` * `dict-of-QString-QVariant readQVariantHash (self)` * `list-of-QVariant readQVariantList (self)` * `dict-of-QString-QVariant readQVariantMap (self)` * `str readRawData (self, int?len)` * `str readString (self)` * `int readUInt16 (self)` * `int readUInt32 (self)` * `int readUInt64 (self)` * `str readUInt8 (self)` * `resetStatus (self)` * `setByteOrder (self, ByteOrder)` * `setDevice (self, QIODevice)` * `setFloatingPointPrecision (self, FloatingPointPrecision?precision)` * `setStatus (self, Status?status)` * `setVersion (self, int?v)` * `int skipRawData (self, int?len)` * `Status status (self)` * `unsetDevice (self)` * `int version (self)` * `writeBool (self, bool?i)` * `QDataStream writeBytes (self, str)` * `writeDouble (self, float?f)` * `writeFloat (self, float?f)` * `writeInt (self, int?i)` * `writeInt16 (self, int?i)` * `writeInt32 (self, int?i)` * `writeInt64 (self, int?i)` * `writeInt8 (self, str?i)` * `writeQString (self, QString?qstr)` * `writeQStringList (self, QStringList?qstrlst)` * `writeQVariant (self, QVariant?qvar)` * `writeQVariantHash (self, dict-of-QString-QVariant?qvarhash)` * `writeQVariantList (self, list-of-QVariant?qvarlst)` * `writeQVariantMap (self, dict-of-QString-QVariant?qvarmap)` * `int writeRawData (self, str)` * `writeString (self, str?str)` * `writeUInt16 (self, int?i)` * `writeUInt32 (self, int?i)` * `writeUInt64 (self, int?i)` * `writeUInt8 (self, str?i)` ### Special Methods * `QDataStream __lshift__ (self, QColor)` * `QDataStream __lshift__ (self, QNetworkCacheMetaData)` * `QDataStream __lshift__ (self, QScriptContextInfo)` * `QDataStream __lshift__ (self, QWebHistory)` * `QDataStream __lshift__ (self, QBrush)` * `QDataStream __lshift__ (self, QHostAddress)` * `QDataStream __lshift__ (self, QCursor?cursor)` * `QDataStream __lshift__ (self, QFont)` * `QDataStream __lshift__ (self, QIcon)` * `QDataStream __lshift__ (self, QImage)` * `QDataStream __lshift__ (self, QKeySequence?ks)` * `QDataStream __lshift__ (self, QListWidgetItem?item)` * `QDataStream __lshift__ (self, QMatrix)` * `QDataStream __lshift__ (self, QMatrix4x4)` * `QDataStream __lshift__ (self, QPainterPath)` * `QDataStream __lshift__ (self, QPalette?p)` * `QDataStream __lshift__ (self, QPen)` * `QDataStream __lshift__ (self, QPicture?p)` * `QDataStream __lshift__ (self, QPixmap)` * `QDataStream __lshift__ (self, QPolygonF?array)` * `QDataStream __lshift__ (self, QPolygon?polygon)` * `QDataStream __lshift__ (self, QQuaternion)` * `QDataStream __lshift__ (self, QRegion)` * `QDataStream __lshift__ (self, QSizePolicy)` * `QDataStream __lshift__ (self, QStandardItem?item)` * `QDataStream __lshift__ (self, QTableWidgetItem?item)` * `QDataStream __lshift__ (self, QTextLength)` * `QDataStream __lshift__ (self, QTextFormat)` * `QDataStream __lshift__ (self, QTransform)` * `QDataStream __lshift__ (self, QTreeWidgetItem?item)` * `QDataStream __lshift__ (self, QVector2D)` * `QDataStream __lshift__ (self, QVector3D)` * `QDataStream __lshift__ (self, QVector4D)` * `QDataStream __rshift__ (self, QColor)` * `QDataStream __rshift__ (self, QNetworkCacheMetaData)` * `QDataStream __rshift__ (self, QScriptContextInfo)` * `QDataStream __rshift__ (self, QWebHistory)` * `QDataStream __rshift__ (self, QBrush)` * `QDataStream __rshift__ (self, QHostAddress)` * `QDataStream __rshift__ (self, QCursor?cursor)` * `QDataStream __rshift__ (self, QFont)` * `QDataStream __rshift__ (self, QIcon)` * `QDataStream __rshift__ (self, QImage)` * `QDataStream __rshift__ (self, QKeySequence?ks)` * `QDataStream __rshift__ (self, QListWidgetItem?item)` * `QDataStream __rshift__ (self, QMatrix)` * `QDataStream __rshift__ (self, QMatrix4x4)` * `QDataStream __rshift__ (self, QPainterPath)` * `QDataStream __rshift__ (self, QPalette?p)` * `QDataStream __rshift__ (self, QPen)` * `QDataStream __rshift__ (self, QPicture?p)` * `QDataStream __rshift__ (self, QPixmap)` * `QDataStream __rshift__ (self, QPolygonF?array)` * `QDataStream __rshift__ (self, QPolygon?polygon)` * `QDataStream __rshift__ (self, QQuaternion)` * `QDataStream __rshift__ (self, QRegion)` * `QDataStream __rshift__ (self, QSizePolicy)` * `QDataStream __rshift__ (self, QStandardItem?item)` * `QDataStream __rshift__ (self, QTableWidgetItem?item)` * `QDataStream __rshift__ (self, QTextLength)` * `QDataStream __rshift__ (self, QTextFormat)` * `QDataStream __rshift__ (self, QTransform)` * `QDataStream __rshift__ (self, QTreeWidgetItem?item)` * `QDataStream __rshift__ (self, QVector2D)` * `QDataStream __rshift__ (self, QVector3D)` * `QDataStream __rshift__ (self, QVector4D)` * `QDataStream __lshift__ (self, QBitArray)` * `QDataStream __lshift__ (self, QByteArray)` * `QDataStream __lshift__ (self, QChar)` * `QDataStream __lshift__ (self, QDate)` * `QDataStream __lshift__ (self, QTime)` * `QDataStream __lshift__ (self, QDateTime)` * `QDataStream __lshift__ (self, QEasingCurve)` * `QDataStream __lshift__ (self, QLine)` * `QDataStream __lshift__ (self, QLineF)` * `QDataStream __lshift__ (self, QLocale)` * `QDataStream __lshift__ (self, QPoint)` * `QDataStream __lshift__ (self, QPointF)` * `QDataStream __lshift__ (self, QRect)` * `QDataStream __lshift__ (self, QRectF)` * `QDataStream __lshift__ (self, QRegExp?regExp)` * `QDataStream __lshift__ (self, QSize)` * `QDataStream __lshift__ (self, QSizeF)` * `QDataStream __lshift__ (self, QString)` * `QDataStream __lshift__ (self, QStringList?list)` * `QDataStream __lshift__ (self, QUrl)` * `QDataStream __lshift__ (self, QUuid)` * `QDataStream __lshift__ (self, QVariant?p)` * `QDataStream __lshift__ (self, Type?p)` * `QDataStream __rshift__ (self, QBitArray)` * `QDataStream __rshift__ (self, QByteArray)` * `QDataStream __rshift__ (self, QChar)` * `QDataStream __rshift__ (self, QDate)` * `QDataStream __rshift__ (self, QTime)` * `QDataStream __rshift__ (self, QDateTime)` * `QDataStream __rshift__ (self, QEasingCurve)` * `QDataStream __rshift__ (self, QLine)` * `QDataStream __rshift__ (self, QLineF)` * `QDataStream __rshift__ (self, QLocale)` * `QDataStream __rshift__ (self, QPoint)` * `QDataStream __rshift__ (self, QPointF)` * `QDataStream __rshift__ (self, QRect)` * `QDataStream __rshift__ (self, QRectF)` * `QDataStream __rshift__ (self, QRegExp?regExp)` * `QDataStream __rshift__ (self, QSize)` * `QDataStream __rshift__ (self, QSizeF)` * `QDataStream __rshift__ (self, QString)` * `QDataStream __rshift__ (self, QStringList?list)` * `QDataStream __rshift__ (self, QUrl)` * `QDataStream __rshift__ (self, QUuid)` * `QDataStream __rshift__ (self, QVariant?p)` * `QDataStream __rshift__ (self, Type?p)` * * * ## Detailed Description 該QDataStream類提供的二進制數據序列化到一個[QIODevice](qiodevice.html)。 數據流是獨立于主機的操作系統， CPU或字節順序的100 ％的編碼信息的二進制流。例如，寫的是Windows下的PC機的數據流可以通過在Sun SPARC上運行的Solaris讀取。 您也可以使用一個數據流讀/寫[raw unencoded binary data](#raw)。如果你想要一個“解析”輸入流，請參閱[QTextStream](qtextstream.html)。 該QDataStream類實現了C + +的基本數據類型的序列化，如`char`，`short`，`int`，`char *`，更復雜的數據序列化等由數據分解成原始單位來完成的。 一個數據流與密切合作[QIODevice](qiodevice.html)。一[QIODevice](qiodevice.html)表示輸入/輸出介質1可以讀取數據和寫入數據到。該[QFile](qfile.html)類是一個I / O設備的一個例子。 例如（寫入二進制數據流） ： ``` [QFile](qfile.html) file("file.dat"); file.open([QIODevice](qiodevice.html).WriteOnly); QDataStream out(&file); // we will serialize the data into the file out << [QString](qstring.html)("the answer is"); // serialize a string out << ([qint32](index.htm#qint32-typedef))42; // serialize an integer ``` 示例（讀取流的二進制數據） ： ``` [QFile](qfile.html) file("file.dat"); file.open([QIODevice](qiodevice.html).ReadOnly); QDataStream in(&file); // read the data serialized from the file [QString](qstring.html) str; [qint32](index.htm#qint32-typedef) a; in >> str >> a; // extract "the answer is" and 42 ``` 寫入流中的每一項是寫在根據項目的不同類型預定義的二進制格式。支持Qt的類型包括[QBrush](qbrush.html)，[QColor](qcolor.html)，[QDateTime](qdatetime.html)，[QFont](qfont.html)，[QPixmap](qpixmap.html)，[QString](qstring.html)，[QVariant](qvariant.html)和其他許多人。對于所有類型的Qt支持的數據流看的完整列表[Serializing Qt Data Types](index.htm)。 對于整數，最好是始終轉換為Qt的整數類型的寫作，和讀回相同Qt的整數類型。這可以確保你得到你想要的大小的整數，并隔離了一些編譯器和平臺的差異。 舉個例子，一個`char *`字符串被寫入作為一個32位整數，等于包括'\ 0'字節，接著是字符串的所有字符，包括'\ 0'字節的字符串的長度。當讀取一個`char *`串的4個字節被讀出以創建32比特長度的值，那么這許多字符的`char *`讀取字符串包括' \ 0 '終止。 最初的I / O設備通常設置在構造函數中，但可以用改變[setDevice](qdatastream.html#setDevice)（ ） 。如果你已經達到了數據的末尾（或如果沒有I / O設備設置）[atEnd](qdatastream.html#atEnd)（ ）將返回True 。 ### Versioning 由于Qt的1.0 QDataStream的二進制格式的演變，并有可能繼續發展，以反映Qt中所作的更改。當輸入或輸出復雜的類型，它是非常重要的，以確保流的同一版本（[version](qdatastream.html#version)（） ）是用于讀取和寫入。如果你需要向前和向后兼容性，您可以硬編碼在應用程序的版本號： ``` stream.setVersion(QDataStream.Qt_4_0); ``` 如果你正在制作一個新的二進制數據格式，如用于您的應用程序創建的文檔的文件格式，你可以使用操作QDataStream寫在便攜格式的數據。通常情況下，你會寫包含magic字符串和版本號給自己空間，未來擴展一個簡短的標題。例如： ``` [QFile](qfile.html) file("file.xxx"); file.open([QIODevice](qiodevice.html).WriteOnly); QDataStream out(&file); // Write a header with a "magic number" and a version out << ([quint32](index.htm#quint32-typedef))0xA0B0C0D0; out << ([qint32](index.htm#qint32-typedef))123; out.setVersion(QDataStream.Qt_4_0); // Write the data out << lots_of_interesting_data; ``` 然后讀取它與： ``` [QFile](qfile.html) file("file.xxx"); file.open([QIODevice](qiodevice.html).ReadOnly); QDataStream in(&file); // Read and check the header [quint32](index.htm#quint32-typedef) magic; in >> magic; if (magic != 0xA0B0C0D0) return XXX_BAD_FILE_FORMAT; // Read the version [qint32](index.htm#qint32-typedef) version; in >> version; if (version < 100) return XXX_BAD_FILE_TOO_OLD; if (version > 123) return XXX_BAD_FILE_TOO_NEW; if (version <= 110) in.setVersion(QDataStream.Qt_3_2); else in.setVersion(QDataStream.Qt_4_0); // Read the data in >> lots_of_interesting_data; if (version >= 120) in >> data_new_in_XXX_version_1_2; in >> other_interesting_data; ``` 你可以選擇其中的字節順序序列化數據時使用。默認設置為大端（高位在前） 。它改變為小端打破了便攜性（除非讀者也改變為小端） 。我們建議保持此設置，除非你有特殊的要求。 ### Reading and writing raw binary data 你不妨讀/寫自己的原始二進制數據到/直接從數據流中。數據可以被從該流讀取到一個預先分配的`char *` using [readRawData](qdatastream.html#readRawData)（ ） 。同樣的數據可以使用被寫入到該流[writeRawData](qdatastream.html#writeRawData)（ ） 。請注意，任何數據編碼/解碼必須由你來完成。 一對相似的功能是[readBytes](qdatastream.html#readBytes)（）和[writeBytes](qdatastream.html#writeBytes)（ ） 。這些從他們的不同_raw_對口如下：[readBytes](qdatastream.html#readBytes)（）讀取被視為將要讀取的數據的長度的quint32 ，則該數目的字節被讀入預先分配的`char *`;[writeBytes](qdatastream.html#writeBytes)（）寫入包含該數據的長度的quint32 ，然后是數據。請注意，數據（除了長度quint32 ）任何編碼/解碼必須由你來完成。 ### Reading and writing Qt collection classes Qt的容器類也可以被序列化到操作QDataStream 。這些措施包括[QList](index.htm)，[QLinkedList](index.htm)，[QVector](index.htm)，[QSet](index.htm)，[QHash](index.htm)和[QMap](index.htm)。流運算符被聲明為類的非成員。 ### Reading and writing other Qt classes. 除了重載流運算符記錄在這里，任何的Qt類，你可能要序列化操作QDataStream將有聲明為類的非成員適當的流運算符： ``` QDataStream &operator<<(QDataStream &, const QXxx &); QDataStream &operator>>(QDataStream &, QXxx &); ``` 例如，這里有流運營商宣布作為非成員[QImage](qimage.html)類： ``` QDataStream & operator<< (QDataStream& stream, const [QImage](qimage.html)& image); QDataStream & operator>> (QDataStream& stream, [QImage](qimage.html)& image); ``` 要看看你最喜歡的Qt類定義了類似的流運算符，請檢查**Related Non-Members**類的文檔頁面的部分。 * * * ## Type Documentation ``` QDataStream.ByteOrder ``` 用于讀取/寫入數據的字節順序。 | Constant | Value | Description | | --- | --- | --- | | `QDataStream.BigEndian` | `QSysInfo.BigEndian` | 第一個最顯著字節（默認） | | `QDataStream.LittleEndian` | `QSysInfo.LittleEndian` | 首先至少顯著字節 | ``` QDataStream.FloatingPointPrecision ``` 用于讀/寫數據的浮點數的精度。這只會產生效果，如果數據流的版本是[Qt_4_6](qdatastream.html#Version-enum)或更高。 **Warning:**浮點精度必須被設置為相同的值，寫入對象并讀取數據流中的對象上。 | Constant | Value | Description | | --- | --- | --- | | `QDataStream.SinglePrecision` | `0` | 在數據流中的所有浮點數具有32位精度。 | | `QDataStream.DoublePrecision` | `1` | 在數據流中的所有浮點數具有64位精度。 | **See also** [setFloatingPointPrecision](qdatastream.html#setFloatingPointPrecision)（）和[floatingPointPrecision](qdatastream.html#floatingPointPrecision)（ ） 。 ``` QDataStream.Status ``` 該枚舉描述了數據流的當前狀態。 | Constant | Value | Description | | --- | --- | --- | | `QDataStream.Ok` | `0` | 該數據流是否正常運行。 | | `QDataStream.ReadPastEnd` | `1` | 該數據流已經讀取過的底層設備中的數據的結尾。 | | `QDataStream.ReadCorruptData` | `2` | 數據流已經讀取損壞的數據。 | | `QDataStream.WriteFailed` | `3` | 數據流不能寫入到基礎設備。 | ``` QDataStream.Version ``` 此枚舉提供了象征性的同義詞，數據序列化格式的版本號。 | Constant | Value | Description | | --- | --- | --- | | `QDataStream.Qt_1_0` | `1` | 版本1 （ Qt的1.x中） | | `QDataStream.Qt_2_0` | `2` | 第2版??（ Qt的2.0） | | `QDataStream.Qt_2_1` | `3` | 第3版（ Qt的2.1 ，2.2， 2.3 ） | | `QDataStream.Qt_3_0` | `4` | 第4版（QT 3.0 ） | | `QDataStream.Qt_3_1` | `5` | 第5版（QT 3.1 ， 3.2 ） | | `QDataStream.Qt_3_3` | `6` | 第6版（QT 3.3 ） | | `QDataStream.Qt_4_0` | `7` | 第7版（QT 4.0 ， Qt的4.1 ） | | `QDataStream.Qt_4_1` | `Qt_4_0` | 第7版（QT 4.0 ， Qt的4.1 ） | | `QDataStream.Qt_4_2` | `8` | 8版本（ Qt 4.2中） | | `QDataStream.Qt_4_3` | `9` | 第9版（QT 4.3 ） | | `QDataStream.Qt_4_4` | `10` | 第10版（QT 4.4 ） | | `QDataStream.Qt_4_5` | `11` | 版本11 （QT 4.5 ） | | `QDataStream.Qt_4_6` | `12` | 版本12 （QT 4.6 ， 4.7的Qt ， Qt的4.8 ） | | `QDataStream.Qt_4_7` | `Qt_4_6` | 同Qt_4_6 。 | | `QDataStream.Qt_4_8` | `Qt_4_7 Qt_4_9 = Qt_4_8` | 同Qt_4_6 。 | **See also** [setVersion](qdatastream.html#setVersion)（）和[version](qdatastream.html#version)（ ） 。 * * * ## Method Documentation ``` QDataStream.__init__ (self) ``` 構造一個沒有I / O設備的數據流。 **See also** [setDevice](qdatastream.html#setDevice)（ ） 。 ``` QDataStream.__init__ (self, QIODevice) ``` 構造一個使用I / O設備的數據流_d_。 **Warning:**如果你使用[QSocket](index.htm#qsocket) or [QSocketDevice](index.htm#qsocketdevice)作為I / O設備_d_讀取數據時，你必須確保有足夠的數據可在套接字的操作來順利進行;[QDataStream](qdatastream.html)沒有任何手段來處理或從短讀取恢復。 **See also** [setDevice](qdatastream.html#setDevice)（）和[device](qdatastream.html#device)（ ） 。 ``` QDataStream.__init__ (self, QByteArray, QIODevice.OpenMode?flags) ``` ``` QDataStream.__init__ (self, QByteArray) ``` 構造一個操作的字節數組上的數據流，_a_。該_mode_描述了設備是如何被使用的。 或者，您也可以使用[QDataStream](qdatastream.html)（常量[QByteArray](qbytearray.html)＆） ，如果你只是想從一個字節數組來讀取。 自[QByteArray](qbytearray.html)是不是一個[QIODevice](qiodevice.html)子類，一個內部[QBuffer](qbuffer.html)創建包的字節數組。 ``` bool QDataStream.atEnd (self) ``` 返回True如果I / O設備已經到達末端位置（流或文件結束），或者如果沒有I / O設備一套，否則返回False 。 **See also** [QIODevice.atEnd](qiodevice.html#atEnd)（ ） 。 ``` ByteOrder QDataStream.byteOrder (self) ``` [](qdatastream.html#ByteOrder-enum) [返回當前字節順序設置 - 無論是](qdatastream.html#ByteOrder-enum)[BigEndian](qdatastream.html#ByteOrder-enum) or [LittleEndian](qdatastream.html#ByteOrder-enum)。 **See also** [setByteOrder](qdatastream.html#setByteOrder)（ ） 。 ``` QIODevice QDataStream.device (self) ``` [ 返回當前設置的I / O設備，或0，如果沒有設備的當前設置。 ](qiodevice.html) [**See also**](qiodevice.html) [setDevice](qdatastream.html#setDevice)（ ） 。 ``` FloatingPointPrecision QDataStream.floatingPointPrecision (self) ``` [ 返回數據流的浮點精度。 此功能被引入Qt的4.6 。 ](qdatastream.html#FloatingPointPrecision-enum) [**See also**](qdatastream.html#FloatingPointPrecision-enum) [FloatingPointPrecision](qdatastream.html#FloatingPointPrecision-enum)和[setFloatingPointPrecision](qdatastream.html#setFloatingPointPrecision)（ ） 。 ``` bool QDataStream.readBool (self) ``` ``` str QDataStream.readBytes (self) ``` 讀取緩沖區_s_從流，并返回一個引用到流。 緩沖區_s_使用分配`new`。與摧毀它`delete[]`運營商。 該_l_參數被設置為緩沖區的長度。如果讀取的字符串是空的，_l_被設置為0 ，并_s_設置為空指針。 序列化格式是quint32長度說明符，然后再_l_字節的數據。 **See also** [readRawData](qdatastream.html#readRawData)（）和[writeBytes](qdatastream.html#writeBytes)（ ） 。 ``` float QDataStream.readDouble (self) ``` ``` float QDataStream.readFloat (self) ``` ``` int QDataStream.readInt (self) ``` ``` int QDataStream.readInt16 (self) ``` ``` int QDataStream.readInt32 (self) ``` ``` int QDataStream.readInt64 (self) ``` ``` str QDataStream.readInt8 (self) ``` ``` QString QDataStream.readQString (self) ``` ``` QStringList QDataStream.readQStringList (self) ``` ``` QVariant QDataStream.readQVariant (self) ``` ``` dict-of-QString-QVariant QDataStream.readQVariantHash (self) ``` ``` list-of-QVariant QDataStream.readQVariantList (self) ``` ``` dict-of-QString-QVariant QDataStream.readQVariantMap (self) ``` ``` str QDataStream.readRawData (self, int?len) ``` 閱讀次數最多_len_從流成字節_s_并返回讀取的字節數。如果發生錯誤，該函數返回-1 。 緩沖區_s_必須預先分配。該數據是_not_編碼。 **See also** [readBytes](qdatastream.html#readBytes)（ ）[QIODevice.read](qiodevice.html#read)（）和[writeRawData](qdatastream.html#writeRawData)（ ） 。 ``` str QDataStream.readString (self) ``` ``` int QDataStream.readUInt16 (self) ``` ``` int QDataStream.readUInt32 (self) ``` ``` int QDataStream.readUInt64 (self) ``` ``` str QDataStream.readUInt8 (self) ``` ``` QDataStream.resetStatus (self) ``` 重置數據流的狀態。 **See also** [Status](qdatastream.html#Status-enum)，[status](qdatastream.html#status)（）和[setStatus](qdatastream.html#setStatus)（ ） 。 ``` QDataStream.setByteOrder (self, ByteOrder) ``` 設置序列化字節順序_bo_。 該_bo_參數可以是[QDataStream.BigEndian](qdatastream.html#ByteOrder-enum) or [QDataStream.LittleEndian](qdatastream.html#ByteOrder-enum)。 默認設置為大端。我們建議您保留此設置，除非你有特殊的要求。 **See also** [byteOrder](qdatastream.html#byteOrder)（ ） 。 ``` QDataStream.setDevice (self, QIODevice) ``` 無效QDataStream.setDevice （[QIODevice](qiodevice.html)* D ） 在I / O設備設置為_d_，它可以是0到未設置到當前的I / O設備。 **See also** [device](qdatastream.html#device)（ ） 。 ``` QDataStream.setFloatingPointPrecision (self, FloatingPointPrecision?precision) ``` 設置數據流的浮點精度_precision_。如果浮點精度[DoublePrecision](qdatastream.html#FloatingPointPrecision-enum)和數據流的版本是[Qt_4_6](qdatastream.html#Version-enum)或更高，所有的浮點數字將被寫入和讀取與64位精度。如果浮點精度[SinglePrecision](qdatastream.html#FloatingPointPrecision-enum)和版本是[Qt_4_6](qdatastream.html#Version-enum)或更高，所有的浮點數字將被寫入和讀取與32位精度。 對于之前的版本[Qt_4_6](qdatastream.html#Version-enum)，的數據流中的浮點數的精度取決于流運算符調用。 默認值是[DoublePrecision](qdatastream.html#FloatingPointPrecision-enum)。 **Warning:**此屬性必須被設置為相同的值，該值寫入對象并讀取該數據流的對象。 此功能被引入Qt的4.6 。 **See also** [floatingPointPrecision](qdatastream.html#floatingPointPrecision)（ ） 。 ``` QDataStream.setStatus (self, Status?status) ``` 設置數據流的狀態到_status_給出。 后續調用setStatus （）被忽略，直到[resetStatus](qdatastream.html#resetStatus)（）被調用。 **See also** [Status](qdatastream.html#Status-enum)，[status](qdatastream.html#status)（）和[resetStatus](qdatastream.html#resetStatus)（ ） 。 ``` QDataStream.setVersion (self, int?v) ``` 設置數據序列化格式的版本號_v_。 你不_have_設置一個版本，如果你正在使用Qt的最新版本，但對于自己的自定義的二進制格式，我們建議你這樣做，見[Versioning](qdatastream.html#versioning)在詳細說明。 為了適應新的功能，一些Qt類的數據流的序列化格式在某些版本的Qt已經改變。如果你想讀通過的Qt的早期版本創建的數據，或寫可以由被與Qt的早期版本編譯的程序可以讀取數據，使用此功能來修改所使用的序列化格式[QDataStream](qdatastream.html)。 | Qt Version | [QDataStream](qdatastream.html) Version | | --- | --- | | Qt 4.6 | 12 | | Qt 4.5 | 11 | | Qt 4.4 | 10 | | Qt 4.3 | 9 | | Qt 4.2 | 8 | | Qt 4.0, 4.1 | 7 | | Qt 3.3 | 6 | | Qt 3.1, 3.2 | 5 | | Qt 3.0 | 4 | | Qt 2.1, 2.2, 2.3 | 3 | | Qt 2.0 | 2 | | Qt 1.x | 1 | 該[Version](qdatastream.html#Version-enum)枚舉提供了不同版本的Qt的符號常量。例如： ``` [QDataStream](qdatastream.html) out(file); out.setVersion([QDataStream](qdatastream.html).Qt_4_0); ``` **See also** [version](qdatastream.html#version)（）和[Version](qdatastream.html#Version-enum)。 ``` int QDataStream.skipRawData (self, int?len) ``` 跳過_len_從設備字節。返回的錯誤字節數居然跳過，或-1 。 這等同于調用[readRawData](qdatastream.html#readRawData)（）的長度的緩沖區_len_而忽略了緩沖區。 這個函數是Qt 4.1中引入。 **See also** [QIODevice.seek](qiodevice.html#seek)（ ） 。 ``` Status QDataStream.status (self) ``` [ 返回數據流的狀態。 ](qdatastream.html#Status-enum) [**See also**](qdatastream.html#Status-enum) [Status](qdatastream.html#Status-enum)，[setStatus](qdatastream.html#setStatus)（）和[resetStatus](qdatastream.html#resetStatus)（ ） 。 ``` QDataStream.unsetDevice (self) ``` ``` int QDataStream.version (self) ``` 返回的數據序列化格式的版本號。 **See also** [setVersion](qdatastream.html#setVersion)（）和[Version](qdatastream.html#Version-enum)。 ``` QDataStream.writeBool (self, bool?i) ``` ``` QDataStream QDataStream.writeBytes (self, str) ``` [ 寫入長度說明_len_和緩沖_s_到流并返回一個引用到流。 該_len_被序列化為一個quint32 ，其次是_len_從字節_s_。注意，該數據是_not_編碼。 ](qdatastream.html) [**See also**](qdatastream.html) [writeRawData](qdatastream.html#writeRawData)（）和[readBytes](qdatastream.html#readBytes)（ ） 。 ``` QDataStream.writeDouble (self, float?f) ``` ``` QDataStream.writeFloat (self, float?f) ``` ``` QDataStream.writeInt (self, int?i) ``` ``` QDataStream.writeInt16 (self, int?i) ``` ``` QDataStream.writeInt32 (self, int?i) ``` ``` QDataStream.writeInt64 (self, int?i) ``` ``` QDataStream.writeInt8 (self, str?i) ``` ``` QDataStream.writeQString (self, QString?qstr) ``` ``` QDataStream.writeQStringList (self, QStringList?qstrlst) ``` ``` QDataStream.writeQVariant (self, QVariant?qvar) ``` ``` QDataStream.writeQVariantHash (self, dict-of-QString-QVariant?qvarhash) ``` ``` QDataStream.writeQVariantList (self, list-of-QVariant?qvarlst) ``` ``` QDataStream.writeQVariantMap (self, dict-of-QString-QVariant?qvarmap) ``` ``` int QDataStream.writeRawData (self, str) ``` Writes _len_從字節_s_到流。返回實際寫入的字節數，或-1。該數據是_not_編碼。 **See also** [writeBytes](qdatastream.html#writeBytes)（ ）[QIODevice.write](qiodevice.html#write)（）和[readRawData](qdatastream.html#readRawData)（ ） 。 ``` QDataStream.writeString (self, str?str) ``` ``` QDataStream.writeUInt16 (self, int?i) ``` ``` QDataStream.writeUInt32 (self, int?i) ``` ``` QDataStream.writeUInt64 (self, int?i) ``` ``` QDataStream.writeUInt8 (self, str?i) ``` ``` QDataStream __lshift__ (self, QColor) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QNetworkCacheMetaData) ``` [ 如果QtNetwork模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QScriptContextInfo) ``` [ 如果QtScript模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QWebHistory) ``` [ 如果QtWebKit的模塊被導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QBrush) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QHostAddress) ``` [ 如果QtNetwork模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QCursor?cursor) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QFont) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QIcon) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QImage) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QKeySequence?ks) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QListWidgetItem?item) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QMatrix) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QMatrix4x4) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QPainterPath) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QPalette?p) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QPen) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QPicture?p) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QPixmap) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QPolygonF?array) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QPolygon?polygon) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QQuaternion) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QRegion) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QSizePolicy) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QStandardItem?item) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QTableWidgetItem?item) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QTextLength) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QTextFormat) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QTransform) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QTreeWidgetItem?item) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QVector2D) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QVector3D) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __lshift__ (self, QVector4D) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QColor) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QNetworkCacheMetaData) ``` [ 如果QtNetwork模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QScriptContextInfo) ``` [ 如果QtScript模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QWebHistory) ``` [ 如果QtWebKit的模塊被導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QBrush) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QHostAddress) ``` [ 如果QtNetwork模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QCursor?cursor) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QFont) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QIcon) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QImage) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QKeySequence?ks) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QListWidgetItem?item) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QMatrix) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QMatrix4x4) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QPainterPath) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QPalette?p) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QPen) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QPicture?p) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QPixmap) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QPolygonF?array) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QPolygon?polygon) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QQuaternion) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QRegion) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QSizePolicy) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QStandardItem?item) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QTableWidgetItem?item) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QTextLength) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QTextFormat) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QTransform) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QTreeWidgetItem?item) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QVector2D) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QVector3D) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream __rshift__ (self, QVector4D) ``` [ 如果QtGui模塊導入此方法僅適用。 ](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QBitArray) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QByteArray) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QChar) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QDate) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QTime) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QDateTime) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QEasingCurve) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QLine) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QLineF) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QLocale) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QPoint) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QPointF) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QRect) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QRectF) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QRegExp?regExp) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QSize) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QSizeF) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QString) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QStringList?list) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QUrl) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QUuid) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, QVariant?p) ``` [](qdatastream.html) ``` QDataStream QDataStream.__lshift__ (self, Type?p) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QBitArray) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QByteArray) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QChar) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QDate) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QTime) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QDateTime) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QEasingCurve) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QLine) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QLineF) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QLocale) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QPoint) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QPointF) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QRect) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QRectF) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QRegExp?regExp) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QSize) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QSizeF) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QString) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QStringList?list) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QUrl) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QUuid) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, QVariant?p) ``` [](qdatastream.html) ``` QDataStream QDataStream.__rshift__ (self, Type?p) ``` [](qdatastream.html)