CWordArray 類別

支援 16 位元字組陣列。

語法

class CWordArray : public CObject

成員

的成員函 CWordArray 式類似于 CObArray 類別 的成員函式 。 由於此相似性，您可以針對成員函式特性使用 CObArray 參考文件。 無論您在何處看到 CObject 指標做為函式參數或傳回值，請取代 WORD。

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

例如，轉換為

WORD CWordArray::GetAt( int <nIndex> ) const;

公用建構函式

名稱	描述
CWordArray：：CWordArray	建構空陣列。

公用方法

名稱	描述
CWordArray：：Add	將項目加入至陣列結尾；必要時讓陣列增長。
CWordArray：：Append	將其他陣列附加至該陣列；必要時讓陣列成長。
CWordArray：：Copy	將其他陣列複製到該陣列；必要時讓陣列成長。
CWordArray：：ElementAt	傳回陣列中項目指標的臨時參考。
CWordArray：：FreeExtra	釋放超過目前上限的所有未使用記憶體。
CWordArray：：GetAt	傳回給定索引的值。
CWordArray：：GetCount	取得此陣列中項目的數目。
CWordArray：：GetData	容許存取陣列中的項目。 可以是 Null。
CWordArray：：GetSize	取得此陣列中項目的數目。
CWordArray：：GetUpperBound	傳回最大的有效索引。
CWordArray：：InsertAt	在指定索引處插入項目 (或其他陣列中的所有項目)。
CWordArray：：IsEmpty	判定陣列是否是空的。
CWordArray：：RemoveAll	從此陣列移除所有項目。
CWordArray：：RemoveAt	移除特定索引處的項目。
CWordArray：：SetAt	設定給定索引的值；不容許陣列成長。
CWordArray：：SetAtGrow	設定給定索引的值；必要時讓陣列成長。
CWordArray：：SetSize	設定此陣列中要包含的項目數目。

公用運算子

名稱	描述
CWordArray::operator[]	設定或取得指定索引處的項目。

備註

CWordArray併入 IMPLEMENT_SERIAL 宏，以支援其專案的序列化和傾印。 如果單字陣列儲存至封存，使用多載插入運算子或 CObject：：Serialize 成員函式，則每個元素會接著序列化。

注意

使用陣列之前，請先使用 SetSize 建立其大小，並為其配置記憶體。 如果您未使用 SetSize，則將項目加入至陣列會導致其被頻繁地重新配置及複製。 頻繁的重新配置及複製效率不高，且可能會讓記憶體分段。

如果您需要陣列中個別專案的傾印，您必須將傾印內容的深度設定為 1 或更大。

如需使用 CWordArray 的詳細資訊，請參閱集合 一文 。

繼承階層架構

CObject

CWordArray

需求

標頭： afxcoll.h

另請參閱

MFC 範例 COLLECT
CObject 類別
階層架構圖表