CArray::GetData

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

更新 : 2007 年 11 月

配列の要素へ直接アクセスする手段を取得します。

const TYPE* GetData( ) const;
TYPE* GetData( );

パラメータ

TYPE
配列要素の型を指定するテンプレートパラメータ。

戻り値

配列要素へのポインタを返します。

解説

要素が存在しない場合、GetData は null 値を返します。

配列の要素へ直接アクセスすることで、処理は迅速になりますが、エラーが発生すると配列の要素へ直接影響を与えるので、GetData の使用には十分注意してください。

使用例

CArray<CPoint,CPoint> myArray;

// Allocate memory for at least 32 elements.
myArray.SetSize(32, 128);

// Add elements to the array.
CPoint* pPt = (CPoint*) myArray.GetData();
for (int i = 0; i < 32; i++, pPt++)
   *pPt = CPoint(i, 2*i);

// Only keep first 5 elements and free extra (unused) bytes.
myArray.SetSize(5, 128);
myArray.FreeExtra();

#if _DEBUG
   afxDump.SetDepth(1);
   afxDump << "myArray: " << &myArray << "\n";
#endif