CByteArray 类
支持字节的动态数组。
语法
class CByteArray : public CObject
成员
CByteArray 的成员函数与 CObArray 类的成员函数类似。 由于此相似性，因此你可以使用 CObArray 参考文档获取成员函数细节。 无论你在何处看到作为函数参数或返回值的 CObject 指针，请替换 BYTE。
CObject* CObArray::GetAt( int <nIndex> ) const;
例如，转换为
BYTE CByteArray::GetAt( int <nIndex> ) const;
公共构造函数
| 名称 | 描述 |
|---|---|
| CByteArray::CByteArray | 构造一个空数组。 |
公共方法
| 名称 | 描述 |
|---|---|
| CByteArray::Add | 向数组的末尾添加一个元素；根据需要扩展该数组。 |
| CByteArray::Append | 将另一个数组追加到该数组中；根据需要扩展该数组。 |
| CByteArray::Copy | 将另一个数组复制到该数组；根据需要扩展该数组。 |
| CByteArray::ElementAt | 返回对数组中字节的临时引用。 |
| CByteArray::FreeExtra | 若高于当前的上限，则将释放所有未使用的内存。 |
| CByteArray::GetAt | 返回给定索引位置处的值。 |
| CByteArray::GetCount | 获取此数组中的元素数。 |
| CByteArray::GetData | 允许访问该数组中的元素。 可以为 NULL。 |
| CByteArray::GetSize | 获取此数组中的元素数。 |
| CByteArray::GetUpperBound | 返回最大的有效索引。 |
| CByteArray::InsertAt | 在指定索引处插入一个元素（或另一个数组中的所有元素）。 |
| CByteArray::IsEmpty | 确定数组是否为空。 |
| CByteArray::RemoveAll | 从此数组中移除所有元素。 |
| CByteArray::RemoveAt | 移除特定索引处的元素。 |
| CByteArray::SetAt | 设置给定索引的值；不允许对该数组进行扩展。 |
| CByteArray::SetAtGrow | 设置给定索引的值；根据需要扩展该数组。 |
| CByteArray::SetSize | 设置要在该数组中包含的元素数。 |
公共运算符
| “属性” | 描述 |
|---|---|
| CByteArray::operator [ ] | 设置或获取位于指定索引处的元素。 |
备注
CByteArray 包括用于支持其元素序列化和转储的 IMPLEMENT_SERIAL 宏。 如果使用重载插入 (<<) 运算符或 Serialize 成员函数将字节数组存储到存档中，则将依次序列化每个元素。
注意
在使用数组之前，先使用 SetSize 建立其大小并为其分配内存。 如果不使用 SetSize，则向数组添加元素会导致它经常重新分配和复制。 经常重新分配和复制会降低效率而且会产生内存碎片。
如果需要数组中各个元素的调试输出，则必须将 CDumpContext 对象的深度设置为 1 或更大。
若要详细了解如何使用 CByteArray，请参阅集合一文。
继承层次结构
CByteArray
要求
标头：afxcoll.h