次の方法で共有


CStringArray クラス

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

構文

class CStringArray : public CObject

メンバー

CStringArrayのメンバー関数は、クラス CObArrayのメンバー関数に似ています。 メンバー関数については CObArray クラスの説明を参照してください。 CObject ポインターが戻り値として表示される場合は、(CString ポインターではなく) CString オブジェクトに置き換えます。 関数パラメーターとして CObject ポインターが使われている場合は、LPCTSTR に置き換えます。

CObject* CObArray::GetAt( int <nIndex> ) const;

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

const CString& CStringArray::GetAt( int <nIndex> ) const;

and

void SetAt( int <nIndex>, CObject* <newElement> )

次のように変換します。

void SetAt( int <nIndex>, LPCTSTR <newElement> )

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

名前 説明
CStringArray::CStringArray 空の配列を生成します。

パブリック メソッド

名前 説明
CStringArray::Add 配列の末尾に要素を追加します。必要に応じて、配列を大きくします。
CStringArray::Append 配列に別の配列を追加します。必要に応じて、配列を大きくします。
CStringArray::Copy 配列に別の配列をコピーします。必要に応じて、配列を大きくします。
CStringArray::ElementAt 配列内の要素ポインターへの一時的な参照を返します。
CStringArray::FreeExtra 現在の上限を超えている未使用のメモリをすべて解放します。
CStringArray::GetAt 指定されたインデックス位置にある値を返します。
CStringArray::GetCount この配列内の要素の数を取得します。
CStringArray::GetData 配列内の要素へのアクセスを許可します。 NULL の可能性があります。
CStringArray::GetSize この配列内の要素の数を取得します。
CStringArray::GetUpperBound 有効な最大のインデックスを返します。
CStringArray::InsertAt 指定されたインデックス位置に要素 (または別の配列内のすべての要素) を挿入します。
CStringArray::IsEmpty 配列が空かどうかを判別します。
CStringArray::RemoveAll この配列からすべての要素を削除します。
CStringArray::RemoveAt 特定のインデックス位置にある要素を削除します。
CStringArray::SetAt 指定されたインデックスの値を設定します。配列は大きくできません。
CStringArray::SetAtGrow 指定されたインデックスの値を設定します。必要に応じて、配列を大きくします。
CStringArray::SetSize この配列に含まれる要素の数を設定します。

パブリック演算子

名前 説明
CStringArray::operator [ ] 指定されたインデックス位置にある要素を設定または取得します。

解説

CStringArray には、IMPLEMENT_SERIAL マクロが組み込まれており、その要素のシリアル化とダンプがサポートされます。 CString オブジェクトの配列がアーカイブに格納される場合、オーバーロードされた挿入演算子または Serialize メンバー関数によって、各要素は順にシリアル化されます。

Note

配列を使用する前に、SetSize を使用してそのサイズを設定し、メモリを割り当てます。 SetSize を使用しない場合、配列に要素を追加すると、配列の再割り当てとコピーが頻繁に発生します。 頻繁な再割り当てとコピーは非効率であり、メモリが断片化される可能性があります。

配列内の個別の文字列要素をダンプする必要があるときは、ダンプ コンテキストの深さを 1 以上に設定する必要があります。

CString 配列が削除されたとき、またはその要素が削除されたときは、文字列メモリは状況に応じて解放されます。

CStringArrayの使用方法の詳細については、Collectionsに関する記事を参照してください。

継承階層

CObject

CStringArray

要件

ヘッダー: afxcoll.h

関連項目

CObject クラス
階層図