CStringList 類別
支援 CString 物件的清單。
語法
class CStringList : public CObject
成員
的成員函 CStringList 式類似於 類別 CObList的成員函式。 由於此相似性，您可以針對成員函式特性使用 CObList 參考文件。 無論您在何處看到 CObject 指標做為傳回值，請取代 （ CString 而非 CString 指標）。 無論您在何處看到 CObject 指標做為函式參數，請取代 LPCTSTR。
CObject*& CObList::GetHead() const;
例如，轉換為
CString& CStringList::GetHead() const;
及
POSITION AddHead( CObject* <newElement> );
轉換為
POSITION AddHead( LPCTSTR <newElement> );
公用建構函式
| 名稱 | 描述 |
|---|---|
CStringList::CStringList |
建構空的清單。 |
公用方法
| 名稱 | 描述 |
|---|---|
CStringList::AddHead |
將元素（或另一個清單中的所有元素）新增至清單的前端（使新的前端）。 |
CStringList::AddTail |
將元素（或另一個清單中的所有元素）新增至清單的尾端（使新的尾端）。 |
CStringList::Find |
取得指標值所指定的專案位置。 |
CStringList::FindIndex |
取得以零起始的索引所指定之專案的位置。 |
CStringList::GetAt |
取得位於指定位置的專案。 |
CStringList::GetCount |
傳回此清單中的項目數目。 |
CStringList::GetHead |
傳回清單的前端元素（不能空白）。 |
CStringList::GetHeadPosition |
傳回清單的 head 元素位置。 |
CStringList::GetNext |
取得反覆運算的下一個專案。 |
CStringList::GetPrev |
取得上一個項目進行反覆運算。 |
CStringList::GetSize |
傳回此清單中的項目數目。 |
CStringList::GetTail |
傳回清單的 tail 元素（不能空白）。 |
CStringList::GetTailPosition |
傳回清單結尾專案的位置。 |
CStringList::InsertAfter |
在指定位置後面插入新專案。 |
CStringList::InsertBefore |
在指定位置之前插入新專案。 |
CStringList::IsEmpty |
測試空白清單條件（沒有元素）。 |
CStringList::RemoveAll |
從此清單中移除所有元素。 |
CStringList::RemoveAt |
從這個清單中移除專案，由位置指定。 |
CStringList::RemoveHead |
從清單的前端移除 專案。 |
CStringList::RemoveTail |
從清單尾端移除 專案。 |
CStringList::SetAt |
設定位於指定位置的專案。 |
備註
所有比較都是以值完成，這表示會比較字串中的字元，而不是字串的位址。
CStringList 引入 IMPLEMENT_SERIAL 巨集，以支援其項目的序列化和傾印。 如果物件清單 CString 儲存至封存，使用多載插入運算符或 Serialize 成員函式，則會接著串行化每個 CString 元素。
如果您需要個別 CString 項目的傾印，您必須將傾印內容的深度設定為1或更新。
如需使用 CStringList的詳細資訊，請參閱集合一文。
繼承階層架構
CStringList
需求
標頭： afxcoll.h