CObArray クラス

CObject ポインターの配列をサポートします。

class CObArray : public CObject

メンバー

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

名前	説明
CObArray::CObArray	CObject ポインターの空の配列を生成します。

パブリック メソッド

名前	説明
CObArray::Add	配列の最後に要素を追加します。必要に応じて配列を拡張します。
CObArray::Append	配列に別の配列を追加します; 配列を必要に応じて。
CObArray::Copy	配列に別の配列をコピーします。必要に応じて配列を拡張します。
CObArray::ElementAt	配列内のポインター要素への一時的な参照を返します。
CObArray::FreeExtra	現在の上限を超える領域の未使用メモリ全体を解放します。
CObArray::GetAt	指定したインデックス位置にある値を返します。
CObArray::GetCount	配列の要素数を取得します。
CObArray::GetData	配列内の要素にアクセスできます。NULL の場合もあります。
CObArray::GetSize	配列の要素数を取得します。
CObArray::GetUpperBound	有効なインデックスの最大値を返します。
CObArray::InsertAt	配列の指定したインデックス位置に要素 (または別の配列のすべての要素) を挿入します。
CObArray::IsEmpty	配列が空であるかどうかを判定します。
CObArray::RemoveAll	配列のすべての要素を削除します。
CObArray::RemoveAt	指定したインデックス位置にある要素を削除します。
CObArray::SetAt	指定したインデックス位置に値を設定します。配列の拡張はできません。
CObArray::SetAtGrow	指定したインデックス位置に値を設定します。必要に応じて配列を拡張します。
CObArray::SetSize	配列に格納する要素数を設定します。

パブリック演算子

名前	説明
CObArray::operator [ ]	指定したインデックス位置の要素を設定または取得します。

解説

これらのオブジェクトの配列は C の配列に似ていますが、必要に応じて動的に縮小し、拡張できます。

配列のインデックスは常に 0 から始まります。現在の境界を越えて要素を追加するかどうかを上限を修正するには、境界または配置するように配列を決定できます。一部の要素が無効 (NULL) の場合でも、メモリは上限まで継続的に割り当てられます。

Win32 の下に、CObArray のオブジェクトのサイズは、使用できるメモリ内だけに制限されます。

C 言語の配列と同じように、CObArray の要素にインデックスを使ってアクセスする時間は一定で、配列のサイズとは無関係です。

CObArray は、要素のシリアル化とダンプをサポートするために IMPLEMENT_SERIAL のマクロが組み込まれています。CObject のポインター配列がオーバーロードされた挿入演算子を使用して、または Serialize のメンバー関数のアーカイブに格納されている場合、CObject の各要素は、配列のインデックスとともに、シリアル化されます。

配列で CObject の各要素をダンプする必要があるときは、を 1 に CDumpContext のオブジェクトの深さを設定するより大きい。

CObArray のオブジェクトを削除または要素が削除されたときに、CObject のポインターだけが削除されますが、参照する、オブジェクト。

[!メモ]

配列を使用する前に、サイズを設定し、そのメモリを割り当てるために SetSize を使用します。SetSize を使用せずに要素を配列に追加すると、配列が頻繁に再割り当てされ、コピーされます。頻繁に再割り当てとコピーを行うとパフォーマンスが低下し、メモリ断片化の原因になります。

配列クラスの派生は、リストの派生に似ています。特殊な目的のクラスの派生リストの詳細については、" " [コレクション]を参照してください。

[!メモ]

配列をシリアル化する場合は、派生クラスの実装で IMPLEMENT_SERIAL のマクロを使用する必要があります。

継承階層

CObject

CObArray

必要条件

Header: afxcoll.h

参照

関連項目

CObject クラス

階層図

CStringArray クラス

CPtrArray クラス

CByteArray クラス

CWordArray クラス

CDWordArray クラス