CObject |
└CPtrList |
CPtrList類支持void指針列表。
CPtrList類的成員函式類似於CObList類的成員函式。由於這種類似性,可以使用CObList參考文檔作為成員函式的說明。無論在任何時候使用一個CObject指針作為函式參數或返回值,都可以將指針替換為void。例如,
CObject*& CObList::Gethead() const;
可以替換成:
void* CPtrList::Gethead() const;
CPtrList嵌入了IMPLEMENT_DYNAMIC宏來支持運行類型訪問和轉儲到CDumpContext對象。如果應用程式需要轉儲各個指針列表元素,則必須將轉儲環境的深度設定為1或大於1。
指針列表不能為NULL。
當一個CPtrList對象被刪除時,或當其元素被刪除時,只刪除指針,而指針所引用的實體並未被刪除。
#include <afxcoll.h>
請參閱:CObList
CPtrList類成員
構造
CPtrList | 構造一個空的void指針列表 |
首/尾訪問
GetHead | 返回列表(不能為空)的頭元素 |
GetTail | 返回列表(不能為空)的尾元素 |
操作
RemoveHead | 移走列表的頭元素 |
RemoveTail | 移走列表的尾元素 |
AddHead | 將一個元素(或另一列表中的所有元素)增加到列表頭(成為新的列表頭) |
AddTail | 將一個元素(或另一列表中的所有元素)增加到列表尾(成為新的列表尾) |
RemoveAll | 從此列表中移走所有元素 |
重複
GetHeadPosition | 返回列表頭元素的位置 |
GetTailPosition | 返回列表尾元素的位置 |
GetNext | 獲取用於重複的下一個元素 |
GetPrev | 獲取用於重複的上一個元素 |
獲取/修改
GetAt | 獲取在給定位置的元素 |
SetAt | 設定在給定位置的元素 |
RemoveAt | 從此列表中移走給定位置的元素 |
插入
InsertBefore | 在一個給定位置之前插入一個新元素 |
InsertAfter | 在一個給定位置之後插入一個新元素 |
搜尋
Find | 獲取一個由指針值指定的元素的位置 |
FindIndex | 獲取由一個索引(從零開始)指定的元素的位置 |
狀態
GetCount | 返回此列表中的元素數目 |
IsEmpty | 測試列表是否為空(無元素) |