qdatastream.html

QT参考文档

<h3 class=fn>int <a name="byteOrder"></a>QDataStream::byteOrder () const
</h3>
返回当前字节顺序设置——不是<a href="#ByteOrder-enum">BigEndian</a>就是<a href="#ByteOrder-enum">LittleEndian</a>。
<p> <p>也可以参考<a href="#setByteOrder">setByteOrder</a>()。

<h3 class=fn><a href="qiodevice.html">QIODevice</a>&nbsp;* <a name="device"></a>QDataStream::device () const
</h3>
返回当前设置的IO设备。
<p>也可以参考<a href="#setDevice">setDevice</a>()和<a href="#unsetDevice">unsetDevice</a>()。

<h3 class=fn>bool <a name="eof"></a>QDataStream::eof () const
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 如果IO设备到达终点（流或文件的终点），或者如果没有IO设备被设置，返回真。
<p> 如果当前的IO的读写位置在终点之前，返回假。
<p> <p>也可以参考<a href="qiodevice.html#atEnd">QIODevice::atEnd</a>()。

<h3 class=fn>bool <a name="isPrintableData"></a>QDataStream::isPrintableData () const
</h3>
如果可打印数据标记已经被设定，返回真。
<p>也可以参考<a href="#setPrintableData">setPrintableData</a>()。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt"></a>QDataStream::operator&lt;&lt; ( Q_INT8&nbsp;i )
</h3>
写一个有符号的字节<em>i</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-2"></a>QDataStream::operator&lt;&lt; ( Q_UINT8&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个无符号的字节<em>i</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-3"></a>QDataStream::operator&lt;&lt; ( Q_INT16&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个有符号的16位整数<em>i</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-4"></a>QDataStream::operator&lt;&lt; ( Q_UINT16&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个无符号的16位整数<em>i</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-5"></a>QDataStream::operator&lt;&lt; ( Q_INT32&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个有符号的32位整数<em>i</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-6"></a>QDataStream::operator&lt;&lt; ( Q_UINT32&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个无符号的32位整数<em>i</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-7"></a>QDataStream::operator&lt;&lt; ( Q_LONG&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个有符号的，长度为系统字长度的整数<em>i</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-8"></a>QDataStream::operator&lt;&lt; ( Q_ULONG&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个无符号的，长度为系统字长度的整数<em>i</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-9"></a>QDataStream::operator&lt;&lt; ( float&nbsp;f )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个使用标准IEEE754格式的32位浮点数<em>f</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-a"></a>QDataStream::operator&lt;&lt; ( double&nbsp;f )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个使用标准IEEE754格式的64位浮点数<em>f</em>到流中并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-lt-lt-b"></a>QDataStream::operator&lt;&lt; ( const&nbsp;char&nbsp;*&nbsp;s )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个以“&#92;0”结尾的字符串<em>s</em>到流中并返回流的引用。
<p> 这个字符串是使用<a href="#writeBytes">writeBytes</a>()串行化的。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt"></a>QDataStream::operator&gt;&gt; ( Q_INT8&nbsp;&amp;&nbsp;i )
</h3>
从流中读取一个有符号的字节到<em>i</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-2"></a>QDataStream::operator&gt;&gt; ( Q_UINT8&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个无符号的字节到<em>i</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-3"></a>QDataStream::operator&gt;&gt; ( Q_INT16&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个有符号的16位整数到<em>i</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-4"></a>QDataStream::operator&gt;&gt; ( Q_UINT16&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个无符号的16位整数到<em>i</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-5"></a>QDataStream::operator&gt;&gt; ( Q_INT32&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个有符号的32位整数到<em>i</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-6"></a>QDataStream::operator&gt;&gt; ( Q_UINT32&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个无符号的32位整数到<em>i</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-7"></a>QDataStream::operator&gt;&gt; ( Q_LONG&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个有符号的，长度为系统字长度的整数到<em>i</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-8"></a>QDataStream::operator&gt;&gt; ( Q_ULONG&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个无符号的，长度为系统字长度的整数到<em>i</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-9"></a>QDataStream::operator&gt;&gt; ( float&nbsp;&amp;&nbsp;f )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个使用标准IEEE754格式的32位浮点数到<em>f</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-a"></a>QDataStream::operator&gt;&gt; ( double&nbsp;&amp;&nbsp;f )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个使用标准IEEE754格式的64位浮点数到<em>f</em>并返回流的引用。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="operator-gt-gt-b"></a>QDataStream::operator&gt;&gt; ( char&nbsp;*&amp;&nbsp;s )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个以“&#92;0”结尾的字符串到<em>s</em>并返回流的引用。
<p> 存放这个字符串的空间是使用<tt>new</tt>来分配的——调用者必须使用<tt>delete[]</tt>来销毁它。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="readBytes"></a>QDataStream::readBytes ( char&nbsp;*&amp;&nbsp;s, uint&nbsp;&amp;&nbsp;l )
</h3>
从流中读取缓存<em>s</em>并返回流的引用。
<p> 这个缓存<em>s</em>是使用<tt>new</tt>来分配的。需要使用<tt>delete[]</tt>来销毁它。如果长度为0或者<em>s</em>没能被分配，<em>s</em>就被设置为0。
<p> <em>l</em>参数将被设置为缓存的长度。
<p> 串行化格式首先是一个Q_UINT32长度的说明符，然后是<em>l</em>字节的数据。注意数据<em>不是</em>编码的。
<p> <p>也可以参考<a href="#readRawBytes">readRawBytes</a>()和<a href="#writeBytes">writeBytes</a>()。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="readRawBytes"></a>QDataStream::readRawBytes ( char&nbsp;*&nbsp;s, uint&nbsp;len )
</h3>
从流中读取<em>len</em>字节到<em>s</em>并返回流的引用。
<p> 这个缓存<em>s</em>必须被预先分配。数据<em>不是</em>编码的。
<p> <p>也可以参考<a href="#readBytes">readBytes</a>()、<a href="qiodevice.html#readBlock">QIODevice::readBlock</a>()和<a href="#writeRawBytes">writeRawBytes</a>()。

<h3 class=fn>void <a name="setByteOrder"></a>QDataStream::setByteOrder ( int&nbsp;bo )
</h3>
设置串行化字节顺序为<em>bo</em>。
<p> <em>bo</em>参数可以是<a href="#ByteOrder-enum">QDataStream::BigEndian</a>或<a href="#ByteOrder-enum">QDataStream::LittleEndian</a>。
<p> 默认设置是高字节在前。我们强烈建议你保留这个设置，除非你有特殊需要。
<p> <p>也可以参考<a href="#byteOrder">byteOrder</a>()。

<h3 class=fn>void <a name="setDevice"></a>QDataStream::setDevice ( <a href="qiodevice.html">QIODevice</a>&nbsp;*&nbsp;d )
</h3>
设置IO设备为<em>d</em>。
<p>也可以参考<a href="#device">device</a>()和<a href="#unsetDevice">unsetDevice</a>()。

<h3 class=fn>void <a name="setPrintableData"></a>QDataStream::setPrintableData ( bool&nbsp;enable )
</h3>
设置（如果<em>enable</em>为真）或者清空可打印数据标记。
<p> 如果这个标记被设置，写函数将生成由可打印字符（7位ASCII码）的输出。
<p> 我们建议只有在调试的情况下打开可打印数据设置（它比较慢并且生成了更多的输出）。

<h3 class=fn>void <a name="setVersion"></a>QDataStream::setVersion ( int&nbsp;v )
</h3>
设置数据串行化格式的版本号。
<p> 如果你只使用当前版本的Qt，你不需要设置这个版本号。
<p> 为了提供新的功能，在一些Qt的版本中，一些Qt类的数据流串行化格式变化了。如果你想读较早版本Qt中创建的数据，或者写可供较早版本Qt编译的程序能够读的数据，请使用这个函数来设置QDataStream的串行化格式。
<p> <ul>
<li> 为了兼容Qt 3.0，请使用<em>v</em> == 4。
<li> 为了兼容Qt 2.1.x和Qt 2.2.x，请使用<em>v</em> == 3。
<li> 为了兼容Qt 2.0.x，请使用<em>v</em> == 2。
<li> 为了兼容Qt 1.x，请使用<em>v</em> == 1。
</ul>
<p> <p>也可以参考<a href="#version">version</a>().

<h3 class=fn>void <a name="unsetDevice"></a>QDataStream::unsetDevice ()
</h3>
清除IO设备。这个和调用<a href="#setDevice">setDevice</a>( 0 )一样。
<p>也可以参考<a href="#device">device</a>()和<a href="#setDevice">setDevice</a>()。

<h3 class=fn>int <a name="version"></a>QDataStream::version () const
</h3>
返回数据串行化格式的版本号。
在Qt 3.0中，这个版本号为4。
<p>也可以参考<a href="#setVersion">setVersion</a>()。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="writeBytes"></a>QDataStream::writeBytes ( const&nbsp;char&nbsp;*&nbsp;s, uint&nbsp;len )
</h3>
写长度说明符<em>len</em>和缓存<em>s</em>到流中并返回流的引用。
<p> <em>len</em>被串行化为一个Q_UINT32，接着的是<em>s</em>中的<em>len</em>字节。注意数据<em>不是</em>编码的。
<p> <p>也可以参考<a href="#writeRawBytes">writeRawBytes</a>()和<a href="#readBytes">readBytes</a>()。

<h3 class=fn><a href="qdatastream.html">QDataStream</a>&nbsp;&amp; <a name="writeRawBytes"></a>QDataStream::writeRawBytes ( const&nbsp;char&nbsp;*&nbsp;s, uint&nbsp;len )
</h3>
从<em>s</em>中写<em>len</em>字节到流中并且返回流的引用。数据<em>不是</em>编码的。
<p> <p>也可以参考<a href="#writeBytes">writeBytes</a>()、<a href="qiodevice.html#writeBlock">QIODevice::writeBlock</a>()和<a href="#readRawBytes">readRawBytes</a>()。

<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 &copy; 1995-2002
<a href="http://www.trolltech.com/">Trolltech</a>。保留所有权利。
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2002 
<a href="http://www.trolltech.com">Trolltech</a>
<td><a href="http://www.trolltech.com/trademarks.html">Trademarks</a>
<td><a href="zh_CN.html">译者:Cavendish</a>
<td align=right><div align=right>Qt 3.0.5版</div>
</table></div></address></body>
</html>