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 マクロが組み込まれており、その要素のシリアル化とダンプがサポートされます。 オーバーロードされた挿入演算子またはSerializeメンバー関数を使用して、CString オブジェクトのリストがアーカイブに格納されている場合、各CString要素が順番にシリアル化されます。
個々の CString 要素のダンプが必要な場合は、ダンプ コンテキストの深さを 1 以上に設定する必要があります。
CStringListの使用方法の詳細については、Collectionsに関する記事を参照してください。
継承階層
CStringList
要件
ヘッダー: afxcoll.h