CPtrArray

CPtrArray類支持void指針數組。

CPtrArray的成員函式類似於CObArray類的成員函式。

基本介紹

• 外文名：CPtrArray
• 支持：void指針數組
• 成員函式：CObArray類的成員函式
• 操作符：operator []
• 嵌入：IMPLEMENT_DYNAMIC宏

簡介

CPtrArray

CObject

└CPtrArray

由於這種相似，你可以利用CObArray參考文檔作為成員函式的說明。無論在何處使用一個CObject指針作為函式參數或返回值，都可以將它替換成void。例如：

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

可以轉換成：

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

CPtrArray嵌入IMPLEMENT_DYNAMIC宏來支持運行時類型訪問和轉儲到一個CDumpContext對象。如果你需要轉儲個別的指針數組元素，你必須將轉儲環境的深度設定為1或更大。

注意

在使用一個數組之前，先用SetSize函式建立數組的大小，並為數組分配記憶體。如果應用程式沒有使用SetSize函式，則向數組中增加元素會使它被頻繁地再分配和拷貝。頻繁再分配和拷貝的效率很低，並且可能使記憶體變得很零碎。

指針數組不能被串列化。

當一個指針數組被刪除時，或當其元素被刪掉時，只刪掉指針，而這些指針所引用的實體不被刪除。

#include <afxcoll.h>

請參閱：CObArray

CPtrArray類成員

構造

CPtrArray

構造一個空的void指針數組

綁定

GetSize	獲取這個數組中的元素個數
GetUpperBound	返回最大的有效索引
SetSize	設定此數組中要包含的元素個數

操作

FreeExtra	釋放超出當前上界的所有未用記憶體
RemoveAll	刪除此數組中的所有元素

元素訪問

GetAt	返回給定索引處的值
SetAt	設定給定索引處的值；數組不運行擴展
ElementAt	返回對數組內的一個元素指針的一個臨時引用
GetData	允許訪問數組中的元素。不能是NULL

擴大數組

SetAtGrow	設定給定索引處的值，如果必要，允許數組擴展
Add	將一個元素增加到數組尾；在必要時擴展數組
Append	將另一個數組添加到此數組；如果必要，則擴展此數組
Copy	將另一個數組拷貝給此數組；如果必要，則擴展此數組

插入/刪除

InsertAt	將一個元素（或另一數組中的所有元素）插入到指定索引處
RemoveAt	刪除指定索引處的元素

操作符

operator []

設定或獲取給定索引處的元素