📄 qbuffer.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-win-commercial-3.0.5/src/tools/qbuffer.cpp:42 -->
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<meta name="Translator" content="Cavendish">
<meta name="Qt zh_CN Documents Website" content="http://www.qiliang.net/qt">
<title>QBuffer类</title>
<style type="text/css"><!--
h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
body { background: #ffffff; color: black; font-family: "Times New Roman" }
--></style>
</head>
<body>
<table border="0" cellpadding="0" cellspacing="0" width="100%">
<tr bgcolor="#E5E5E5">
<td valign=center>
<a href="index.html">
<font color="#004faf">主页</font></a>
| <a href="classes.html">
<font color="#004faf">所有的类</font></a>
| <a href="mainclasses.html">
<font color="#004faf">主要的类</font></a>
| <a href="annotated.html">
<font color="#004faf">注释的类</font></a>
| <a href="groups.html">
<font color="#004faf">分组的类</font></a>
| <a href="functions.html">
<font color="#004faf">函数</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table>
<h1 align=center>QBuffer类参考</h1>
<p>QBuffer类是一个操作QByteArray的输入/输出设备。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qbuffer-h.html">qbuffer.h</a>></tt>
<p>继承了<a href="qiodevice.html">QIODevice</a>。
<p><a href="qbuffer-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn><a href="#QBuffer"><b>QBuffer</b></a> ()</div></li>
<li><div class=fn><a href="#QBuffer-2"><b>QBuffer</b></a> ( QByteArray buf )</div></li>
<li><div class=fn><a href="#~QBuffer"><b>~QBuffer</b></a> ()</div></li>
<li><div class=fn>QByteArray <a href="#buffer"><b>buffer</b></a> () const</div></li>
<li><div class=fn>bool <a href="#setBuffer"><b>setBuffer</b></a> ( QByteArray buf )</div></li>
<li><div class=fn>virtual Q_LONG <a href="#writeBlock"><b>writeBlock</b></a> ( const char * p, Q_ULONG len )</div></li>
<li><div class=fn>Q_LONG <a href="#writeBlock-2"><b>writeBlock</b></a> ( const QByteArray & data )</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
QBuffer类是一个操作<a href="qbytearray.html">QByteArray</a>的输入/输出设备。
<p> QBuffer是用来读写内存缓存的。它通常与<a href="qtextstream.html">QTextStream</a>或<a href="qdatastream.html">QDataStream</a>一起使用。QBuffer有一个相关联的QByteArray用来存储缓冲数据。缓冲的大小（<a href="qiodevice.html#size">size</a>()）会根据所写的数据自动调整。
<p> 构造函数<tt>QBuffer(QByteArray)</tt>以一个现有的字节数组创建一个QBuffer。字节数组也可以由<a href="#setBuffer">setBuffer</a>()来设置。向QBuffer写将会更改初始字节数组，因为QByteArray是<a href="shclass.html">明确共享</a>。
<p> 在使用之前使用<a href="qiodevice.html#open">open</a>()来打开缓存并且设置模式（只读、只写等等）。<a href="qiodevice.html#close">close</a>()可以关闭缓存。在重新打开或者调用setBuffer()之前缓存必须被关闭。
<p> 使用QBuffer的一个普通方式是通过<a href="qdatastream.html">QDataStream</a>或<a href="qtextstream.html">QTextStream</a>，它们可以通过一个QBuffer参数来构造。为了方便，QDataStream和<a href="qtextstream.html">QTextStream</a>也可以使用一个<a href="qbytearray.html">QByteArray</a>参数来构造。这些构造函数创建并且打开一个内部的QBuffer。
<p> 注意QTextStream也可以操作<a href="qstring.html">QString</a>（一个Unicode字符串），而QBuffer不能。
<p> 你也可以直接通过标准的<a href="qiodevice.html">QIODevice</a>函数<a href="qiodevice.html#readBlock">readBlock</a>()、<a href="#writeBlock">writeBlock</a>()、<a href="qiodevice.html#readLine">readLine</a>()、<a href="qiodevice.html#at">at</a>(),、<a href="qiodevice.html#getch">getch</a>()、<a href="qiodevice.html#putch">putch</a>()和<a href="qiodevice.html#ungetch">ungetch</a>()来使用QBuffer。
<p> <p>也可以参考<a href="qfile.html">QFile</a>、<a href="qdatastream.html">QDataStream</a>、<a href="qtextstream.html">QTextStream</a>、<a href="qbytearray.html">QByteArray</a>、<a href="shclass.html">共享类</a>、 <a href="collection.html">集合类</a>和<a href="io.html">输入/输出和网络</a>。
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QBuffer"></a>QBuffer::QBuffer ()
</h3>
构造一个空的缓存。
<h3 class=fn><a name="QBuffer-2"></a>QBuffer::QBuffer ( <a href="qbytearray.html">QByteArray</a> buf )
</h3>
操作<em>buf</em>来构造一个缓存。
如果你使用写模式（<a href="qfile.html#open">IO_WriteOnly</a>或者<a href="qfile.html#open">IO_ReadWrite</a>）打开缓存并且写一些东西到缓存，<em>buf</em>将被修改。
<p> 实例：
<pre>
<a href="qcstring.html">QCString</a> str = "abc";
QBuffer b( str );
b.<a href="qiodevice.html#open">open</a>( IO_WriteOnly );
b.<a href="qiodevice.html#at">at</a>( 3 ); // 定位到第四个字符（终结符\0）
b.<a href="#writeBlock">writeBlock</a>( "def", 4 ); // 写入“def”，包括终结符\0
b.<a href="qiodevice.html#close">close</a>();
// 现在，str就是“abcdef”和一个终结符\0
</pre>
<p> <p>也可以参考<a href="#setBuffer">setBuffer</a>()。
<h3 class=fn><a name="~QBuffer"></a>QBuffer::~QBuffer ()
</h3>
析构缓存。
<h3 class=fn><a href="qbytearray.html">QByteArray</a> <a name="buffer"></a>QBuffer::buffer () const
</h3>
<p> 返回这个缓存的字节数组。
<p> <p>也可以参考a href="#setBuffer">setBuffer</a>()。
<h3 class=fn>bool <a name="setBuffer"></a>QBuffer::setBuffer ( <a href="qbytearray.html">QByteArray</a> buf )
</h3>
把缓存的内容替换为<em>buf</em>。
<p> 当<a href="qiodevice.html#isOpen">isOpen</a>()为真时，这个操作也许不能被完成。
<p> 注意如果你使用写模式（<a href="qfile.html#open">IO_WriteOnly</a>或者<a href="qfile.html#open">IO_ReadWrite</a>）打开缓存并且写一些东西到缓存，<em>buf</em>也会被修改因为<a href="qbytearray.html">QByteArray</a>是一个<a href="shclass.html#explicitly-shared">明显共享</a>类。
<p> <p>也可以参考<a href="#buffer">buffer</a>()、<a href="qiodevice.html#open">open</a>()和<a href="qiodevice.html#close">close</a>()。
<h3 class=fn>Q_LONG <a name="writeBlock"></a>QBuffer::writeBlock ( const char * p, Q_ULONG len )<tt> [虚]</tt>
</h3>
<p> 把<em>p</em>中的<em>len</em>字节写到缓存的当前索引位置，如果需要的话，将会覆盖原有的数据并且扩充缓存。返回实际所写的字节数量。
<p> 如果发生任何错误，返回-1。
<p> <p>也可以参卡<a href="qiodevice.html#readBlock">readBlock</a>()。
<p>Reimplemented from <a href="qiodevice.html#writeBlock">QIODevice</a>.
<h3 class=fn>Q_LONG <a name="writeBlock-2"></a>QBuffer::writeBlock ( const <a href="qbytearray.html">QByteArray</a> & data )
</h3>
这是一个重载成员函数，提供方便。它的行为和上面的函数基本一致。
<p> 这个方便的函数使用<em>data</em>与调用<a href="#writeBlock">writeBlock</a>( data.data(), data.<a href="#size">size</a>() )是一样的。
<p>
<!-- eof -->
<hr><p>
这个文件是<a href="index.html">Qt工具包</a>一部分。
版权所有 © 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 © 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>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -