基本介紹
CStringList,#include <afxcoll.h>,構造,首/尾訪問,操作,重複,獲取/修改,插入,搜尋,狀態,
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++程式設計師指南”中的文章“集合”。
#include <afxcoll.h>
CStringList類成員
構造
CStringList | 構造一個空的CString對象列表 |
首/尾訪問
GetHead | 返回此列表(不能是空的)中頭部的元素 |
GetTail | 返回此列表(不能是空的)中尾部的元素 |
操作
RemoveHead | 從列表的頭部刪除元素 |
RemoveTail | 從列表的尾部刪除元素 |
在列表的頭部添加一個元素(或者是另一個列表中的所有元素),即產生一個新的頭部 | |
AddTail | 在列表的尾部添加一個元素(或者是另一個列表中的所有元素),即產生一個新的尾部 |
刪除此列表中的所有元素 |
重複
GetHeadPosition | 返回列表中的頭部元素的位置 |
GetTailPosition | 返回列表中尾部元素的位置 |
GetNext | 獲取用於重複的下一個元素 |
GetPrev | 獲取用於重複的前一個元素 |
獲取/修改
獲取給定位置處的元素 | |
SetAt | 設定給定位置處的元素 |
RemoveAt | 從此列表中刪除由位置指定的一個元素 |
插入
InsertBefore | 在一個給定位置之前插入一個新元素 |
InsertAfter | 在一個給定位置之後插入一個新元素 |