複製鏈接
請複製以下鏈接發送給好友

CStringList

鎖定
CStringList的成員函數類似於類CObList類的成員函數。由於具有這些相似性,你可以參考關於CObList的參考文件來獲取CStringList成員函數的詳細説明。如果在説明中看到某一函數的返回值是一個指向CObject對象的指針,則可以用一個CString(而不是一個CString指針)來代替它。如果看到某一函數的參數是一個指向CObject的指針,則可以用LPCTSTR來代替它。
外文名
CStringList
類似於
CObList類的成員函數
RemoveHead
從列表的頭部刪除元素
RemoveTail
從列表的尾部刪除元素

CStringList術語簡介

└CStringList
CStringList類支持CString對象的列表。所有的比較都是通過值比較來完成的,這意味着不是比較字符串的地址而是比較字符串中的字符。
例如,可以將
CObject*& CObList::GetHead() const;
轉換為
CString& CStringList::GetHead() const;
和將
POSITION AddHead( CObject* <newElement> );
轉換為
POSITION AddHead( LPCTSTR <newElement> );
CStringList與IMPLEMENT_SERIAL宏聯合起來支持其元素的連續和轉儲。如果一個CString對象列表被用一個重載的插入操作符Serialize成員函數保存到一個存檔中,則它的每一個元素都按順序連續。
如果你需要數組中個別字符串元素的轉儲,則應該將轉儲環境的深度設置為1或更大。
當一個CStringList對象被刪除時,或當它的元素被刪除時,則相應的CString對象被刪除。
有關使用CStringList的更多信息,參見“Visual C++程序員指南”中的文章“集合”。

CStringList使用情況

#include
CStringList類成員

CStringList構造

CStringList
構造一個空的CString對象列表

CStringList首尾訪問

GetHead
返回此列表(不能是空的)中頭部的元素
GetTail
返回此列表(不能是空的)中尾部的元素

CStringList操作

RemoveHead
從列表的頭部刪除元素
RemoveTail
從列表的尾部刪除元素
在列表的頭部添加一個元素(或者是另一個列表中的所有元素),即產生一個新的頭部
AddTail
在列表的尾部添加一個元素(或者是另一個列表中的所有元素),即產生一個新的尾部
刪除此列表中的所有元素

CStringList重複

GetHeadPosition
返回列表中的頭部元素的位置
GetTailPosition
返回列表中尾部元素的位置
GetNext
獲取用於重複的下一個元素
GetPrev
獲取用於重複的前一個元素

CStringList獲取、修改

獲取給定位置處的元素
SetAt
設置給定位置處的元素
RemoveAt
從此列表中刪除由位置指定的一個元素

CStringList插入

InsertBefore
在一個給定位置之前插入一個新元素
InsertAfter
在一個給定位置之後插入一個新元素

CStringList搜索

獲取由字符串值指定的元素的位置
FindIndex
獲取由一個從零開始的索引指定的元素的位置

CStringList狀態

返回此列表中的元素個數
測試列表是否為空(沒有元素)