qtextstream.html

QT参考文档

构造一个通过内部<a href="qbuffer.html">QBuffer</a>设备操作字节数组<em>a</em>的文本流。<em>filemode</em>参数会被传递给设备的open()函数，请参考<a href="qiodevice.html#mode">QIODevice::mode</a>()。
<p> 实例：
<pre>
    <a href="qbytearray.html">QByteArray</a> array;
    QTextStream ts( array, <a href="qfile.html#open">IO_WriteOnly</a> );
    ts &lt;&lt; "pi = " &lt;&lt; 3.14 &lt;&lt; '\0'; // array == "pi = 3.14"
  </pre>
 
<p> 写数据到文本流将会修改数组的内容。如果所写的内容超过数组的范围，数组会被扩大。
<p> 同样的实例，使用QBuffer：
<pre>
    <a href="qbytearray.html">QByteArray</a> array;
    <a href="qbuffer.html">QBuffer</a> buf( array );
    buf.<a href="qiodevice.html#open">open</a>( IO_WriteOnly );
    QTextStream ts( &amp;buf );
    ts &lt;&lt; "pi = " &lt;&lt; 3.14 &lt;&lt; '\0'; // array == "pi = 3.14"
    buf.<a href="qiodevice.html#close">close</a>();
  </pre>
 

<h3 class=fn><a name="QTextStream-6"></a>QTextStream::QTextStream ( FILE&nbsp;*&nbsp;fh, int&nbsp;mode )
</h3>  
构造一个通过内部的<a href="qfile.html">QFile</a>设备操作已经存在的文件句柄<em>fh</em>的文本流。<em>filemode</em>参数会被传递给设备的open()函数，请参考<a href="qiodevice.html#mode">QIODevice::mode</a>()。
<p> 注意如果你创建了一个QTextStream<tt>cout</tt>或者也被其他类型的另一个变量使用的另一个名称，一些连接器也许会搞混这两个变量，这经常会导致程序崩溃。

<h3 class=fn><a name="~QTextStream"></a>QTextStream::~QTextStream ()<tt> [虚]</tt>
</h3>
销毁这个文本流。
<p> 这个析构函数对当前IO设备没有任何影响。

<h3 class=fn>bool <a name="atEnd"></a>QTextStream::atEnd () const
</h3>
如果IO设备已经达到终点（流或文件的终点），或者如果没有IO设备被设置，返回真，否则返回假。
<p> <p>也可以参考<a href="qiodevice.html#atEnd">QIODevice::atEnd</a>()。
<p>实例：<a href="addressbook-example.html#x550">addressbook/centralwidget.cpp</a>和<a href="grapher-nsplugin-example.html#x2782">grapher/grapher.cpp</a>。

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

<h3 class=fn>bool <a name="eof"></a>QTextStream::eof () const
</h3>
<p> <b>这个函数是废弃的。</b>它的提供只是为了保证旧代码能够工作。我们强烈建议在新代码中不要使用它。
<p> 这个函数已经被重新命名为<a href="#atEnd">atEnd</a>()。
<p> <p>也可以参考<a href="qiodevice.html#atEnd">QIODevice::atEnd</a>()。
<p>实例：<a href="tutorial2-07.html#x2497">chart/chartform_files.cpp</a>。

<h3 class=fn>int <a name="fill"></a>QTextStream::fill () const
</h3>
返回填充字符。默认值是“ ”（空格）。

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

<h3 class=fn>int <a name="flags"></a>QTextStream::flags () const
</h3>
返回当前的流标记。默认值为0。
<p> 标记的意义是：
<ul>
<li> <em>skipws</em> - 当前不被使用了，控制符总是被忽略
<li> <em>left</em> - 数字字段左对齐
<li> <em>right</em> - 当前不被使用了（默认情况下，数字字段是右对齐的）
<li> <em>internal</em> - 在+/-和值的中间填充空格
<li> <em>bin</em> - 输入<em>和</em>输出只使用二进制
<li> <em>oct</em> - 输入<em>和</em>输出只使用八进制
<li> <em>dec</em> - 输入<em>和</em>输出只使用十进制
<li> <em>hex</em> - 输入<em>和</em>输出只使用十六进制
<li> <em>showbase</em> - 如果使用<em>bin</em>、<em>oct</em>或<em>hex</em>格式，数字输出使用0b、0和0x注释
<li> <em>showpoint</em> - 当前不被使用了
<li> <em>uppercase</em> - 使用0B和0X，而不用0b和0x
<li> <em>showpos</em> - 对正数显示+
<li> <em>scientific</em> - 对浮点数使用科学记数法
<li> <em>fixed</em> - 对浮点数使用固定的位数
</ul>
<p> 注意，如果没有设置<em>bin</em>、<em>oct</em>、<em>dec</em>或<em>hex</em>，那么一个以0开始的值被认为是八进制的，以0x开始的被认为是十六进制的，以0b开始的被认为是二进制的，其它的都被认为是十进制的。
<p> <p>也可以参考<a href="#setf">setf</a>()和<a href="#unsetf">unsetf</a>()。

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

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-lt-lt"></a>QTextStream::operator&lt;&lt; ( <a href="qchar.html">QChar</a>&nbsp;c )
</h3>
写<tt>字符</tt><em>c</em>到流中并且返回流的引用。
<p> <tt>字符</tt><em>c</em>不依赖于QTextStream的编码设置，被假设为Latin1编码。

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

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

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

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

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

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

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

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-lt-lt-9"></a>QTextStream::operator&lt;&lt; ( float&nbsp;f )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写<tt>单精实型</tt><em>f</em>到流中并且返回流的引用。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-lt-lt-a"></a>QTextStream::operator&lt;&lt; ( double&nbsp;f )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写<tt>双精实型</tt><em>f</em>到流中并且返回流的引用。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-lt-lt-b"></a>QTextStream::operator&lt;&lt; ( const&nbsp;char&nbsp;*&nbsp;s )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个字符串到流中并且返回流的引用。
<p> 字符串<em>s</em>不依赖于QTextStream的编码设置，被假设为Latin1编码。


<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-lt-lt-c"></a>QTextStream::operator&lt;&lt; ( const&nbsp;<a href="qstring.html">QString</a>&nbsp;&amp;&nbsp;s )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个<em>s</em>到流中并且返回流的引用。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-lt-lt-d"></a>QTextStream::operator&lt;&lt; ( const&nbsp;<a href="qcstring.html">QCString</a>&nbsp;&amp;&nbsp;s )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个<em>s</em>到流中并且返回流的引用。
<p> 字符串<em>s</em>不依赖于QTextStream的编码设置，被假设为Latin1编码。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-lt-lt-e"></a>QTextStream::operator&lt;&lt; ( void&nbsp;*&nbsp;ptr )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> 写一个指针到流中并且返回流的引用。
<p> <em>ptr</em>是被作为十六进制的无符号的长整型输出的。

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt"></a>QTextStream::operator&gt;&gt; ( <a href="qchar.html">QChar</a>&nbsp;&amp;&nbsp;c )
</h3>
从流中读取一个<tt>字符</tt><em>c</em>并且返回流的引用。
注意控制符<em>不</em>被忽略。

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

<h3 class=fn><a href="qtextstream.html">QTextStream</a>&nbsp;&amp; <a name="operator-gt-gt-3"></a>QTextStream::operator&gt;&gt; ( signed&nbsp;short&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-4"></a>QTextStream::operator&gt;&gt; ( unsigned&nbsp;short&nbsp;&amp;&nbsp;i )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。