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> );
パブリック コンストラクター
名前 |
説明 |
---|---|
空のリストを構築します。 |
パブリック メソッド
名前 |
説明 |
---|---|
要素 (またはほかのリストのすべての要素) をリストの先頭に追加します (その要素を新たに先頭とします)。 |
|
要素 (またはほかのリストのすべての要素) をリストの末尾に追加します (その要素を新たに末尾とします)。 |
|
ポインターの値で指定された要素の位置を取得します。 |
|
0 から始まるインデックスで示される要素の位置を取得します。 |
|
指定した位置の要素を取得します。 |
|
リストの要素数を返します。 |
|
リストの先頭要素を返します。リストが空のときは使用できません。 |
|
リストの先頭要素の位置を返します。 |
|
次の要素を順番に取得します。 |
|
順次アクセスするときの直前の要素を取得します。 |
|
リストの要素数を返します。 |
|
リストの末尾要素を返します。リストが空のときは使用できません。 |
|
リストの末尾要素の位置を返します。 |
|
指定した位置の後ろに新しい要素を挿入します。 |
|
指定した位置の前に新しい要素を挿入します。 |
|
リストの状態が空 (要素がない) かどうかを調べます。 |
|
リストからすべての要素を削除します。 |
|
位置で指定されたこの一覧から要素を削除します。 |
|
リストの先頭にある要素を削除します。 |
|
リストの末尾にある要素を削除します。 |
|
指定した位置に要素を設定します。 |
解説
すべての比較は、文字列内の文字が文字列のアドレスではなく比較されることを意味する値によって実行されます。
CStringList は、要素のシリアル化とダンプをサポートするために IMPLEMENT_SERIAL のマクロが組み込まれています。CString オブジェクトの一覧がオーバーロードされた挿入演算子を使用して、または Serialize のメンバー関数のアーカイブに格納されている場合、CString の各要素では、シリアル化されます。
CString の各要素をダンプする必要があるときは、1 にダンプ コンテキストの深さを設定するより大きい。
CStringListの使用の詳細については、" " [コレクション]を参照してください。
継承階層
CStringList
必要条件
Header: afxcoll.h