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 的詳細資訊，請參閱集合 一文 。

繼承階層架構

CObject

CByteArray

需求

標頭： afxcoll.h

另請參閱

CObject 類別
階層架構圖表
CObArray 類別