📄 qmemarray.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- /home/reggie/tmp/qt-3.0-reggie-5401/qt-x11-commercial-3.0.5/doc/qmemarray.doc:41 -->
<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>QMemArray类</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>QMemArray类参考</h1>
<p>QMemArray类是一个提供简单类型的数组的模板类。
<a href="#details">详情请见……</a>
<p><tt>#include <<a href="qmemarray-h.html">qmemarray.h</a>></tt>
<p>被<a href="qbytearray.html">QByteArray</a>和<a href="qpointarray.html">QPointArray</a>继承。
<p><a href="qmemarray-members.html">所有成员函数的列表。</a>
<h2>公有成员</h2>
<ul>
<li><div class=fn>typedef type * <a href="#Iterator"><b>Iterator</b></a></div></li>
<li><div class=fn>typedef const type * <a href="#ConstIterator"><b>ConstIterator</b></a></div></li>
<li><div class=fn><a href="#QMemArray-2"><b>QMemArray</b></a> ()</div></li>
<li><div class=fn><a href="#QMemArray-3"><b>QMemArray</b></a> ( int size )</div></li>
<li><div class=fn><a href="#QMemArray-4"><b>QMemArray</b></a> ( const QMemArray<type> & a )</div></li>
<li><div class=fn><a href="#~QMemArray"><b>~QMemArray</b></a> ()</div></li>
<li><div class=fn>QMemArray<type> & <a href="#operator-eq"><b>operator=</b></a> ( const QMemArray<type> & a )</div></li>
<li><div class=fn>type * <a href="#data"><b>data</b></a> () const</div></li>
<li><div class=fn>uint <a href="#nrefs"><b>nrefs</b></a> () const</div></li>
<li><div class=fn>uint <a href="#size"><b>size</b></a> () const</div></li>
<li><div class=fn>uint <a href="#count"><b>count</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isEmpty"><b>isEmpty</b></a> () const</div></li>
<li><div class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</div></li>
<li><div class=fn>bool <a href="#resize"><b>resize</b></a> ( uint size )</div></li>
<li><div class=fn>bool <a href="#truncate"><b>truncate</b></a> ( uint pos )</div></li>
<li><div class=fn>bool <a href="#fill"><b>fill</b></a> ( const type & v, int size = -1 )</div></li>
<li><div class=fn>virtual void <a href="#detach"><b>detach</b></a> ()</div></li>
<li><div class=fn>QMemArray<type> <a href="#copy"><b>copy</b></a> () const</div></li>
<li><div class=fn>QMemArray<type> & <a href="#assign"><b>assign</b></a> ( const QMemArray<type> & a )</div></li>
<li><div class=fn>QMemArray<type> & <a href="#assign-2"><b>assign</b></a> ( const type * data, uint size )</div></li>
<li><div class=fn>QMemArray<type> & <a href="#duplicate"><b>duplicate</b></a> ( const QMemArray<type> & a )</div></li>
<li><div class=fn>QMemArray<type> & <a href="#duplicate-2"><b>duplicate</b></a> ( const type * data, uint size )</div></li>
<li><div class=fn>QMemArray<type> & <a href="#setRawData"><b>setRawData</b></a> ( const type * data, uint size )</div></li>
<li><div class=fn>void <a href="#resetRawData"><b>resetRawData</b></a> ( const type * data, uint size )</div></li>
<li><div class=fn>int <a href="#find"><b>find</b></a> ( const type & v, uint index = 0 ) const</div></li>
<li><div class=fn>int <a href="#contains"><b>contains</b></a> ( const type & v ) const</div></li>
<li><div class=fn>void <a href="#sort"><b>sort</b></a> ()</div></li>
<li><div class=fn>int <a href="#bsearch"><b>bsearch</b></a> ( const type & v ) const</div></li>
<li><div class=fn>type & <a href="#operator[]"><b>operator[]</b></a> ( int index ) const</div></li>
<li><div class=fn>type & <a href="#at"><b>at</b></a> ( uint index ) const</div></li>
<li><div class=fn><a href="#operator-const-type-*"><b>operator const type *</b></a> () const</div></li>
<li><div class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const QMemArray<type> & a ) const</div></li>
<li><div class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const QMemArray<type> & a ) const</div></li>
<li><div class=fn>Iterator <a href="#begin"><b>begin</b></a> ()</div></li>
<li><div class=fn>Iterator <a href="#end"><b>end</b></a> ()</div></li>
<li><div class=fn>ConstIterator <a href="#begin-2"><b>begin</b></a> () const</div></li>
<li><div class=fn>ConstIterator <a href="#end-2"><b>end</b></a> () const</div></li>
</ul>
<h2>保护成员</h2>
<ul>
<li><div class=fn><a href="#QMemArray"><b>QMemArray</b></a> ( int, int )</div></li>
</ul>
<h2>相关函数</h2>
<ul>
<li><div class=fn>Q_UINT16 <a href="#qChecksum"><b>qChecksum</b></a> ( const char * data, uint len )</div></li>
<li><div class=fn>QDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( QDataStream & s, const QByteArray & a )</div></li>
<li><div class=fn>QDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( QDataStream & s, QByteArray & a )</div></li>
</ul>
<hr><a name="details"></a><h2>详细描述</h2>
QMemArray是一个提供简单类型的数组的模板类。
<p>
<p> QMemArray是作为模板类实现的。定义一个模板实例QMemArray<X>可以创建一个包含X数据项的数组。
<p> QMemArray直接在数组中存储数组元素。它只能处理简单类型（比如，C++类型、结构体和没有构造函数、析构函数和虚函数的类）。QMemArray使用逐位的操作来复制和比较数组元素。
<p> <a href="qptrvector.html">QPtrVector</a>集合类也是一种数组。就像所有的<a href="collection.html">集合类</a>一样，它存储的是指向所包含的数据项的指针。
<p> QMemArray通过一个引用计数器使用明显<a href="shclass.html">共享</a>。如果超过一个的数组共享公有的数据并且，一个数组被修改的时候，所有的数组都将被修改。
<p> 共享的好处就是程序可以在不被需要复制的时候就不必再复制了，这样的结果就是可以减少的内存使用和数据复制了。
<p> 实例：
<pre>
#include <<a href="qmemarray-h.html">qmemarray.h</a>>
#include <stdio.h>
QMemArray<int> fib( int num ) // 返回斐波纳契数列
{
<a href="qapplication.html#Q_ASSERT">Q_ASSERT</a>( num > 2 );
QMemArray<int> f( num ); // 整形数组
f[0] = f[1] = 1;
for ( int i = 2; i < num; i++ )
f[i] = f[i-1] + f[i-2];
return f;
}
int main()
{
QMemArray<int> a = fib( 6 ); // get 6 first fibonaccis
for ( int i = 0; i < a.<a href="#size">size</a>(); i++ )
<a href="qapplication.html#qDebug">qDebug</a>( "%d: %d", i, a[i] );
<a href="qapplication.html#qDebug">qDebug</a>( "1 is found %d times", a.<a href="#contains">contains</a>(1) );
<a href="qapplication.html#qDebug">qDebug</a>( "5 is found at index %d", a.<a href="#find">find</a>(5) );
return 0;
}
</pre>
<p> 程序输出：
<pre>
0: 1
1: 1
2: 2
3: 3
4: 5
5: 8
1 is found 2 times
5 is found at index 4
</pre>
<p> 使用QMemArray来操作结构体或者类的时候需要注意：编译器经常会在结构体后面加一些不定长的东西从而达到最近的字边界。这就将是QMemArray用来做逐位元素比较的大小了。因为剩余的字节将不被初始化，这将导致<a href="#find">find</a>()等等在查找元素时失败。实例：
<p> <pre>
// MyStruct也许会被加上4或8字节
struct MyStruct
{
short i; // 2 bytes
char c; // 1 byte
};
QMemArray<MyStruct> a(1);
a[0].i = 5;
a[0].c = 't';
MyStruct x;
x.i = '5';
x.c = 't';
int i = a.<a href="#find">find</a>( x ); // 如果所加上的字节不同，也许会返回-1
</pre>
<p> 为了能在这种情况下工作，确认你使用的结构体使用sizeof()返回到大小和各个成员的大小之和相同，否则通过改变结构体成员的类型或者加入一些虚构的成员来解决这个问题。
<p> QMemArray数据可以通过迭代器来遍历（请看<a href="#begin">begin</a>()和<a href="#end">end</a>()）。数据项的数量可以由<a href="#count">count</a>()返回。可以用<a href="#resize">resize</a>()重新定义数组的大小并且用<a href="#fill">fill</a>()填充。
<p> 你可以使用a href="#assign">assign</a>()（或者<a href="#operator-eq">operator=</a>()）来做<a href="shclass.html#shallow-copy">浅复制</a>，可以使用<a href="#duplicate">duplicate</a>()来做<a href="shclass.html#deep-copy">深复制</a>。
<p> 在数组中搜索值可以用<a href="#find">find</a>()和<a href="#contains">contains</a>()。在排过序的数组（请看<a href="#sort">sort</a>()）中搜索可以使用<a href="#bsearch">bsearch</a>()。
<p> 你可以直接使用<a href="#setRawData">setRawData</a>()和<a href="#resetRawData">resetRawData</a>()来直接设置数据，但是这需要注意。
<p> <p>也可以参考<a href="shclass.html">共享类</a>和<a href="tools.html">非GUI的类</a>。
<hr><h2>成员类型文档</h2>
<h3 class=fn><a name="ConstIterator"></a>QMemArray::ConstIterator</h3>
一个常量的QMemArray迭代器。
<p>也可以参考<a href="#begin">begin</a>()和<a href="#end">end</a>()。
<h3 class=fn><a name="Iterator"></a>QMemArray::Iterator</h3>
一个QMemArray迭代器。
<p>也可以参考<a href="#begin">begin</a>()和<a href="#end">end</a>()。
<hr><h2>成员函数文档</h2>
<h3 class=fn><a name="QMemArray"></a>QMemArray::QMemArray ( int, int )<tt> [保护]</tt>
</h3>
构造一个数组<em>但不分配</em>数组空间。参数必须为(0, 0)。使用的时候你要自己承担风险。
<h3 class=fn><a name="QMemArray-2"></a>QMemArray::QMemArray ()
</h3>
构造一个空数组。
<p>也可以参考<a href="#isNull">isNull</a>()。
<h3 class=fn><a name="QMemArray-3"></a>QMemArray::QMemArray ( int size )
</h3>
构造一个为<em>size</em>个元素提供空间的数组。如果<em>size</em>==0，就是一个空数组。
<p> 元素没有被初始化。
<p> <p>也可以参考<a href="#resize">resize</a>()和<a href="#isNull">isNull</a>()。
<h3 class=fn><a name="QMemArray-4"></a>QMemArray::QMemArray ( const <a href="qmemarray.html">QMemArray</a><type> & a )
</h3>
构造一个<em>a</em>的<a href="shclass.html#shallow-copy">浅复制</a>。
<p>也可以参考<a href="#assign">assign</a>()。
<h3 class=fn><a name="~QMemArray"></a>QMemArray::~QMemArray ()
</h3>
数组数据的引用计数减一并且如果这是最后一个引用就删除它。
<h3 class=fn><a href="qmemarray.html">QMemArray</a><type> & <a name="assign"></a>QMemArray::assign ( const <a href="qmemarray.html">QMemArray</a><type> & a )
</h3>
<a href="shclass.html#shallow-copy">浅复制</a>。数组数据的引用计数减一并且相反地引用<em>a</em>中包含的数据。返回这个数组的引用。
<p>也可以参考<a href="#operator-eq">operator=</a>()。
<h3 class=fn><a href="qmemarray.html">QMemArray</a><type> & <a name="assign-2"></a>QMemArray::assign ( const type * data, uint size )
</h3>
这是一个重载成员函数，提供了方便。它的行为基本上和上面的函数相同。
<p> <a href="shclass.html#shallow-copy">浅复制</a>。数组数据的引用计数减一并且相反地引用包含了<em>size</em>个元素的数组数据<em>data</em>。返回这个数组的引用。
<p> 在这之后不要删除<em>data</em>，QMemArray会维护它的。
<h3 class=fn>type & <a name="at"></a>QMemArray::at ( uint index ) const
</h3>
返回数组中在<em>index</em>位置的元素的引用。
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -