CPtrList

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

相關詞條

相關搜尋

熱門詞條

聯絡我們