CAtlArray クラス

[アーティクル]
02/21/2013

このクラスは、配列オブジェクトを実装します。

template< 
   typename E,
   class ETraits = CElementTraits< E > 
>
class CAtlArray

パラメーター

E
配列に格納されるデータの型。
ETraits
要素をコピーまたは移動するときに使用するコード。

メンバー

メソッド

追加	配列オブジェクトに要素を追加するには、このメソッドを呼び出します。
追加します。	別の最後に 1 二つの配列の内容を追加するには、このメソッドを呼び出します。
AssertValid	配列オブジェクトが有効であることを確認するためにこのメソッドを呼び出します。
CAtlArray	コンストラクターです。
~CAtlArray	デストラクターです。
コピー	別の型に 1 個の配列の要素をコピーする場合は、このメソッドを呼び出します。
FreeExtra	空の配列から要素を削除するには、このメソッドを呼び出します。
GetAt	配列オブジェクトから単一の要素を取得するときにこのメソッドを呼び出します。
GetCount	配列に格納されている要素の数を返すには、このメソッドを呼び出します。
GetData	配列の最初の要素へのポインターを返すには、このメソッドを呼び出します。
InsertArrayAt	別の型に 1 個の配列を挿入する場合に、このメソッドを呼び出します。
InsertAt	配列オブジェクトに新しい要素または要素の複数のコピーを挿入する場合に、このメソッドを呼び出します。
IsEmpty	配列が空テストするには、このメソッドを呼び出します。
RemoveAll	配列オブジェクトからすべての要素を削除するには、このメソッドを呼び出します。
RemoveAt	配列から要素を削除するには、このメソッドを呼び出します。
SetAt	配列オブジェクトの要素の値を設定するには、このメソッドを呼び出します。
SetAtGrow	配列を配置する必要に応じて配列オブジェクトの要素の値を設定するには、このメソッドを呼び出します。
SetCount	配列オブジェクトのサイズを設定するには、このメソッドを呼び出します。

演算子

operator []

配列の要素への参照を返すには、この演算子を呼び出します。

Typedef

INARGTYPE	配列に要素を追加するために使用するデータ型。
OUTARGTYPE	配列から要素を取得するために使用するデータ型。

解説

CAtlArray、ユーザー定義型の要素の配列を作成および管理するためのメソッドを提供します。標準 C の配列に似ていますが、CAtlArray のオブジェクトは、必要に応じて動的に縮小し、拡張できます。新しい要素が追加される場合、位置 0 の配列のインデックスは常にの開始され、上限が修正または配置することを許可できます。

一部の要素を持つ配列は、ATL のクラス CSimpleArray を使用できます。

CAtlArray は、MFC の CArray のクラスに密接に関連し、MFC プロジェクトでシリアル化のサポートなしで、とはいえ動作します。

詳細については、ATL のコレクションクラスを参照してください。