CPtrArray 類別

支援 void 指標的陣列。

語法

class CPtrArray : public CObject

成員

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

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

例如，轉換為

void* CPtrArray::GetAt( int <nIndex> ) const;

公用建構函式

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

公用方法

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

公用運算子

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

備註

CPtrArray 併入 IMPLEMENT_DYNAMIC 宏，以支援執行時間類型存取和傾印至 CDumpContext 物件。 如果您需要個別指標陣列元素的傾印，您必須將傾印內容的深度設定為 1 或更新。

注意

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

指標陣列無法序列化。

刪除指標陣列或移除其元素時，只會移除指標，而不是它們參考的實體。

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

繼承階層架構

CObject

CPtrArray

需求

標頭： afxcoll.h

另請參閱

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