CObArray::SetAtGrow

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

指定したインデックス位置に配列要素を格納します。

void SetAtGrow(
   INT_PTR nIndex,
   CObject* newElement 
);

パラメータ

nIndex
0 以上の整数のインデックス。
newElement
配列に追加するオブジェクトポインタ。NULL 値も指定できます。

解説

必要に応じて、配列を自動的に拡張します (つまり、新しい要素を格納できるように上限が調整されます)。

CObArray::SetAtGrow に類似している他のメンバ関数を以下に示します。

クラス	メンバ関数
CByteArray	void SetAtGrow( INT_PTRnIndex, BYTEnewElement ); *throw( CMemoryException );**
CDWordArray	void SetAtGrow( INT_PTRnIndex, DWORDnewElement ); *throw( CMemoryException );**
CPtrArray	void SetAtGrow( INT_PTRnIndex, voidnewElement ); throw( CMemoryException );**
CStringArray	void SetAtGrow( INT_PTRnIndex, LPCTSTRnewElement ); *throw( CMemoryException );**
CUIntArray	void SetAtGrow( INT_PTRnIndex, UINTnewElement ); *throw( CMemoryException );**
CWordArray	void SetAtGrow( INT_PTRnIndex, WORDnewElement ); *throw( CMemoryException );**

使用例

すべてのコレクションの例で使われている CAge クラスのリストについては、CObList::CObList を参照してください。

CObArray arr;

arr.Add(new CAge(21)); // Element 0
arr.Add(new CAge(40)); // Element 1
arr.SetAtGrow(3, new CAge(65)); // Element 2 deliberately
                                      // skipped.
#ifdef _DEBUG
   afxDump.SetDepth(1);
   afxDump << _T("SetAtGrow example: ") << &arr << _T("\n");
#endif

このプログラムの実行結果は次のようになります。

SetAtGrow example: A CObArray with 4 elements

[0] = a CAge at $47C0 21

[1] = a CAge at $4800 40

[2] = NULL

[3] = a CAge at $4840 65