| 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 | 測試列表是否為空(無元素) |
