CStringList クラス

CString オブジェクトのリストをサポートします。

構文

class CStringList : public CObject

メンバー

のメンバー関数 CStringList は、クラス CObListのメンバー関数に似ています。 メンバー関数については CObList クラスの説明を参照してください。 ポインターがCObject戻り値として表示される場合は、(ポインターではなくCString) をCString置き換える必要があります。 ポインターが CObject 関数パラメーターとして表示される場合は、次の値に置き換える必要があります LPCTSTR。

CObject*& CObList::GetHead() const;

たとえば、次のように変換します。

CString& CStringList::GetHead() const;

and

POSITION AddHead( CObject* <newElement> );

次のように変換します。

POSITION AddHead( LPCTSTR <newElement> );

パブリック コンストラクター

名前	説明
CStringList::CStringList	空のリストを作成します。

パブリック メソッド

名前	説明
CStringList::AddHead	要素 (または別のリスト内のすべての要素) をリストの先頭に追加します (新しい先頭を作成します)。
CStringList::AddTail	リストの末尾に要素 (または別のリストのすべての要素) を追加します (新しい末尾を作成します)。
CStringList::Find	ポインター値で指定された要素の位置を取得します。
CStringList::FindIndex	0 から始まるインデックスで指定された要素の位置を取得します。
CStringList::GetAt	指定した位置にある要素を取得します。
CStringList::GetCount	このリスト内の要素の数を返します。
CStringList::GetHead	リストのヘッド要素を返します (空にすることはできません)。
CStringList::GetHeadPosition	リストのヘッド要素の位置を返します。
CStringList::GetNext	次に反復処理の対象となる要素が取得されます。
CStringList::GetPrev	反復する前の要素を取得します。
CStringList::GetSize	このリスト内の要素の数を返します。
CStringList::GetTail	リストの末尾要素を返します (空にすることはできません)。
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の詳細については、コレクションに関する記事を参照してください。

継承階層

CObject

CStringList

必要条件

ヘッダー:afxcoll.h

関連項目

MFC サンプル COLLECT
CObject クラス
階層図