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に関する記事を参照してください。
継承階層
CStringArray
要件
ヘッダー: afxcoll.h