qtextstream.html

QT参考文档

<p> 从流中读取一个<tt>无符号的短整型</tt><em>i</em>并且返回流的引用。对于所希望的输入格式的说明，请参考<a href="#flags">flags</a>()。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-5"></a>QTextStream::operator&gt;&gt; ( signed&nbsp;int&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个<tt>有符号的整型</tt><em>i</em>并且返回流的引用。对于所希望的输入格式的说明，请参考<a href="#flags">flags</a>()。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-6"></a>QTextStream::operator&gt;&gt; ( unsigned&nbsp;int&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个<tt>无符号的整型</tt><em>i</em>并且返回流的引用。对于所希望的输入格式的说明，请参考<a href="#flags">flags</a>()。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-7"></a>QTextStream::operator&gt;&gt; ( signed&nbsp;long&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个<tt>有符号的长整型</tt><em>i</em>并且返回流的引用。对于所希望的输入格式的说明，请参考<a href="#flags">flags</a>()。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-8"></a>QTextStream::operator&gt;&gt; ( unsigned&nbsp;long&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个<tt>无符号的长整型</tt><em>i</em>并且返回流的引用。对于所希望的输入格式的说明，请参考<a href="#flags">flags</a>()。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-9"></a>QTextStream::operator&gt;&gt; ( float&nbsp;&amp;&nbsp;f )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个<tt>单精实型</tt><em>f</em>并且返回流的引用。对于所希望的输入格式的说明，请参考<a href="#flags">flags</a>()。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-a"></a>QTextStream::operator&gt;&gt; ( double&nbsp;&amp;&nbsp;f )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个<tt>双精实型</tt><em>f</em>并且返回流的引用。对于所希望的输入格式的说明，请参考<a href="#flags">flags</a>()。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-b"></a>QTextStream::operator&gt;&gt; ( char&nbsp;*&nbsp;s )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个“词”<em>s</em>并且返回流的引用。对于所希望的输入格式的说明。
<p> 一个词是由isspace()返回假的字符组成。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-c"></a>QTextStream::operator&gt;&gt; ( <a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;str )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个“词”<em>str</em>并且返回流的引用。对于所希望的输入格式的说明。
<p> 一个词是由isspace()返回假的字符组成。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-d"></a>QTextStream::operator&gt;&gt; ( <a href="qcstring.html">QCString</a>&nbsp;&amp;&nbsp;str )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 从流中读取一个“词”<em>str</em>并且返回流的引用。对于所希望的输入格式的说明。
<p> 一个词是由isspace()返回假的字符组成。

<h3 class=fn>int <a name="precision"></a>QTextStream::precision () const
</h3>
返回精确度。默认值为6。

<h3 class=fn>int <a name="precision-2"></a>QTextStream::precision ( int&nbsp;p )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 设置精确度为<em>p</em>。返回以前设置的精确度。

<h3 class=fn><a href="qstring.html">QString</a> <a name="read"></a>QTextStream::read ()
</h3>
读取整个流并且返回包含文本的字符串。
<p> <p>也可以参考<a href="qiodevice.html#readLine">QIODevice::readLine</a>().
<p>实例：<a href="qaction-application-example.html#x1095">action/application.cpp</a>、<a href="simple-application-example.html#x1540">application/application.cpp</a>、<a href="mdi-example.html#x2043">mdi/application.cpp</a>、<a href="qdir-example.html#x1840">qdir/qdir.cpp</a>和<a href="qwerty-example.html#x399">qwerty/qwerty.cpp</a>。

<h3 class=fn><a href="qstring.html">QString</a> <a name="readLine"></a>QTextStream::readLine ()
</h3>
读取流中的一行并且返回包含文本的字符串。
<p> 返回的字符串不包含任何换行符和回车符。注意这是和<a href="qiodevice.html#readLine">QIODevice::readLine</a>()不一样的，后者不会省略一行最后的换行符。
<p> 在EOF处，你会得到一个零<a href="qstring.html">QString</a>。在读取一个空行时你得到的QString是空的，但不是零。
<p> <p>也可以参考<a href="qiodevice.html#readLine">QIODevice::readLine</a>()。
<p>实例：<a href="addressbook-example.html#x551">addressbook/centralwidget.cpp</a>和<a href="tutorial2-03.html#x2456">chart/element.cpp</a>。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="readRawBytes"></a>QTextStream::readRawBytes ( char&nbsp;*&nbsp;s, uint&nbsp;len )
</h3>
从流中读取<em>len</em>字节放到<em>s</em>中并且返回流的引用。
<p> 缓存<em>s</em>必须被预先分配。
<p> 注意这个函数中不使用任何编码方式。
<p> <b>警告：</b>除非流的编码方式被设置为Unicode或者Latin1，这个函数的行为会是不确定的。
<p> <p>也可以参考<a href="qiodevice.html#readBlock">QIODevice::readBlock</a>()。

<h3 class=fn>void <a name="reset"></a>QTextStream::reset ()
</h3>
重新设置文本流为默认设置。
<p> <ul>
<li> 所有标记被设置为0。
<li> 所有字段宽度被设置为0。
<li> 所有填充字符被设置为“ ”（空格）。
<li> 精确度被设置为6。
</ul>
<p> <p>也可以参考<a href="#setf">setf</a>()、<a href="#width">width</a>()、<a href="#fill">fill</a>()和<a href="#precision">precision</a>()。

<h3 class=fn>void <a name="setCodec"></a>QTextStream::setCodec ( <a href="qtextcodec.html">QTextCodec</a>&nbsp;*&nbsp;codec )
</h3>  
设置流的编码器为<em>codec</em>。如果不设置，会自动设置为Unicode。
<p> 注意这个函数的调用应该发生在这个流进行读/写数据之前。
<p> <p>也可以参考<a href="#setEncoding">setEncoding</a>()。
<p>实例：<a href="qwerty-example.html#x400">qwerty/qwerty.cpp</a>。

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

<h3 class=fn>void <a name="setEncoding"></a>QTextStream::setEncoding ( <a href="qtextstream.html#Encoding-enum">Encoding</a>&nbsp;e )
</h3>
设置这个流的编码为<em>e</em>，<em>e</em>为下列之一：
<ul>
<li> Locale - 使用本地文件格式（如果本地没有设置，就是Latin1），但是会在输入时自动检测是否Unicode（utf16）。
<li> Unicode - 使用Unicode（utf16）作为输入和输出。输出将会根据当前平台中最有效率的顺序写出来（比如，<a href="qstring.html">QString</a>内部使用的顺序）。
<li> UnicodeUTF8 - 使用Unicode（utf8）作为输入和输出。如果使用它作为输入，它将会自动检测是否utf16，如果是的话，将会使用它代替utf8。
<li> Latin1 - ISO-8859-1。将不会自动检测utf16。
<li> UnicodeNetworkOrder - 使用网络顺序的Unicode（utf16）作为输入和输出。当读取不使用字节顺序标记的Unicode的时候是有用的。
<li> UnicodeReverse - 使用与网络顺序相反的顺序的Unicode（utf16）作为输入和输出。当读取不使用字节顺序标记或者当写供bug很多的Windows应用程序读取的数据的Unicode的时候是有用的。
<li> RawUnicode - 就像Unicode，但是不写字节顺序标记，也不自动检测字节顺序标记。只有当写供一个单独进程使用的非永久保存的数据的时候是有用的。
</ul>
<p> <a href="#Encoding-enum">Locale</a>和所有的Unicode编码，除了<a href="#Encoding-enum">RawUnicode</a>，都将看输入流的头两个字节来决定字节顺序。这个初始的字节顺序标记将会在读数据之前省略掉。<p> 注意这个函数的调用应该发生在这个流进行读/写数据之前。
<p> <p>也可以参考<a href="#setCodec">setCodec</a>()。
<p>实例：<a href="httpd-example.html#x647">network/httpd/httpd.cpp</a>和<a href="qwerty-example.html#x401">qwerty/qwerty.cpp</a>。

<h3 class=fn>int <a name="setf"></a>QTextStream::setf ( int&nbsp;bits )
</h3>
设置流的标记位为<em>bits</em>。返回以前设置的流标记。
<p> 和<tt>flags( flags() | bits )</tt>是一样的。
<p> <p>也可以参考<a href="#unsetf">unsetf</a>()。

<h3 class=fn>int <a name="setf-2"></a>QTextStream::setf ( int&nbsp;bits, int&nbsp;mask )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
设置流的标记位为<em>bits</em>和一个位掩码<em>mask</em>。返回以前设置的流标记。
<p> 和<tt>flags( (flags() &amp; ~mask) | (bits &amp; mask) )</tt>是一样的。
<p> <p>也可以参考<a href="#unsetf">unsetf</a>()。

<h3 class=fn>void <a name="skipWhiteSpace"></a>QTextStream::skipWhiteSpace ()
</h3>
放置读指针在第一个非控制字符上。

<h3 class=fn>void <a name="unsetDevice"></a>QTextStream::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="unsetf"></a>QTextStream::unsetf ( int&nbsp;bits )
</h3>
清空流标记位<em>bits</em>。返回以前设置的流标记。
<p> 和<tt>flags( flags() &amp; ~mask )</tt>是一样的。
<p> <p>也可以参考<a href="#setf">setf</a>()。

<h3 class=fn>int <a name="width"></a>QTextStream::width () const
</h3>
返回字段宽度。默认值为0。

<h3 class=fn>int <a name="width-2"></a>QTextStream::width ( int&nbsp;w )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 设置字段宽度为<em>w</em>。返回以前设置的字段宽度。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="writeRawBytes"></a>QTextStream::writeRawBytes ( const&nbsp;char&nbsp;*&nbsp;s, uint&nbsp;len )
</h3>
从<em>s</em>写<em>len</em>字节到流中并且返回流的引用。
<p> 注意这个函数没有使用任何编码。
<p> <p>也可以参考<a href="qiodevice.html#writeBlock">QIODevice::writeBlock</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>