CObArray选件类

支持某些 CObject 指针。

class CObArray : public CObject

成员

088sck34.collapse_all(zh-cn,VS.110).gif公共构造函数

名称

说明

CObArray::CObArray

构造 CObject 指针的空数组。

088sck34.collapse_all(zh-cn,VS.110).gif公共方法

名称

说明

CObArray::Add

将元素添加到数组的结尾;如果需要,增长数组。

CObArray::Append

追加另一个数组传递给数组;如果需要,增长数组。

CObArray::Copy

复制另一个数组传递给数组;如果需要,增长数组。

CObArray::ElementAt

返回临时对数组中的元素指针。

CObArray::FreeExtra

释放在当前上限的任何未使用的内存。

CObArray::GetAt

返回值在给定索引。

CObArray::GetCount

获取元素的数目该数组中的。

CObArray::GetData

允许对组件的访问该数组。可以是 NULL

CObArray::GetSize

获取元素的数目该数组中的。

CObArray::GetUpperBound

返回最大的有效的索引。

CObArray::InsertAt

插入元素(或在其他元素中的所有元素数组)在指定的索引。

CObArray::IsEmpty

确定数组是否为空。

CObArray::RemoveAll

从此数组中移除所有元素。

CObArray::RemoveAt

移除元素在一个枚举索引。

CObArray::SetAt

为特定的索引值;不允许的数组增大。

CObArray::SetAtGrow

为特定的索引值;如果需要,增长数组。

CObArray::SetSize

设置该数组将包含的元素的数目。

088sck34.collapse_all(zh-cn,VS.110).gif公共运算符

名称

说明

CObArray::operator [ ]

设置或获取元素位于指定索引处。

备注

这些对象数组类似于C数组,但是,它们可以动态缩小且根据需要增大。

数组索引始终是开始在位置0。当添加通过当前区域时,的元素是否可以决定修复了上限或允许数组展开。连续内存分配给上限,因此,即使某些元素为空。

在Win32下,CObArray 对象的范围仅限于可用内存。

具有c.数组,CObArray 索引的元素的访问时间是常数是数组大小无关。

CObArray 合并 IMPLEMENT_SERIAL 宏支持序列化和转储其元素。如果数组 CObject 指针存储到存档,与重载、运算符或与 Serialize 成员函数,每个 CObject 元素与其数组索引。,反过来,序列化。

如果在数组需要各个 CObject 元素转储,必须设置 CDumpContext 对象的深度为1或更大。

CObArray 对象被删除,或者,如果移除元素,因此,只有这些引用移除的 CObject 指针,而不是对象。

说明说明

在使用数组之前,请使用 SetSize 建立它的大小并将其分配的内存。如果不使用 SetSize,将元素添加到的数组使其最频繁分配和复制。常见的重新分配和复制是低效的,并且可能产生内存碎片。

数组选件类派生类似的列表派生。有关在派生的详细信息私有列表选件类,请参见一 集合文章。

说明说明

因此,如果您希望序列化数组,已在派生类中实现必须使用 IMPLEMENT_SERIAL 宏。

继承层次结构

CObject

CObArray

要求

Header: afxcoll.h

请参见

参考

CObject选件类

层次结构图

CStringArray选件类

CPtrArray选件类

CByteArray类选件

CWordArray选件类

CDWordArray选件类