CPtrList

CPtrList

CPtrList類的成員函數類似於CObList類的成員函數。由於這種類似性,可以使用CObList參考文檔作為成員函數的說明。無論在任何時候使用一個CObject指針作為函數參數或返回值,都可以將指針替換為void

目錄

正文


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