CByteArray类选件

支持动态字节。

class CByteArray : public CObject

成员

CByteArray 的成员函数类似于选件类 CObArray的成员函数。 因此相似性，可以使用 CObArray 引用成员函数特定的文档。 无论在何处参见 CObject 指针作为函数参数或返回值，请替换 BYTE。

CObject* CObArray::GetAt( int <nIndex> ) const;

例如，转换

BYTE CByteArray::GetAt( int <nIndex> ) const;

公共构造函数

名称	说明
CObArray::CObArray	构造一个空数组。

公共方法

名称	说明
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	设置该数组将包含的元素的数目。

公共运算符

名称	说明
CObArray::operator [ ]	设置或获取元素位于指定索引处。

备注

CByteArray 合并 IMPLEMENT_SERIAL 宏支持序列化和转储其元素。 如果字节存储到存档，与重载中插入 (<<) 运算符或与 Serialize 成员函数，反过来，序列化每个元素。

备注

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

如果需要调试从各个元素的输出在数组，则必须将 CDumpContext 对象的深度为1或更大。

有关使用 CByteArray的更多信息，请参见文章 集合。

继承层次结构

CObject

CByteArray

要求

Header: afxcoll.h

请参见

参考

CObject选件类

层次结构图

CObArray选件类