CByteArray クラス

バイトの動的配列をサポートします。

構文

class CByteArray : public CObject

メンバー

のメンバー関数 CByteArray は、クラス CObArray のメンバー関数に似ています。 メンバー関数については CObArray クラスの説明を参照してください。 ポインターが CObject 関数パラメーターまたは戻り値として表示される場合は、BYTE に置き換えます。

CObject* CObArray::GetAt( int <nIndex> ) const;

たとえば、次のように変換します。

BYTE CByteArray::GetAt( int <nIndex> ) const;

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

名前	説明
CByteArray::CByteArray	空の配列を生成します。

パブリック メソッド

名前	説明
CByteArray::Add	配列の末尾に要素を追加します。必要に応じて、配列を大きくします。
CByteArray::Append	配列に別の配列を追加します。必要に応じて、配列を大きくします。
CByteArray::Copy	配列に別の配列をコピーします。必要に応じて、配列を大きくします。
CByteArray::ElementAt	配列内のバイトへの一時的な参照を返します。
CByteArray::FreeExtra	現在の上限を超えている未使用のメモリをすべて解放します。
CByteArray::GetAt	指定されたインデックス位置にある値を返します。
CByteArray::GetCount	この配列内の要素の数を取得します。
CByteArray::GetData	配列内の要素へのアクセスを許可します。 NULL にすることができます。
CByteArray::GetSize	この配列内の要素の数を取得します。
CByteArray::GetUpperBound	有効な最大のインデックスを返します。
CByteArray::InsertAt	指定されたインデックス位置に要素 (または別の配列内のすべての要素) を挿入します。
CByteArray::IsEmpty	配列が空かどうかを判別します。
CByteArray::RemoveAll	この配列からすべての要素を削除します。
CByteArray::RemoveAt	特定のインデックス位置にある要素を削除します。
CByteArray::SetAt	指定されたインデックスの値を設定します。配列は大きくできません。
CByteArray::SetAtGrow	指定されたインデックスの値を設定します。必要に応じて、配列を大きくします。
CByteArray::SetSize	この配列に含まれる要素の数を設定します。

パブリック演算子

名前	説明
CByteArray::operator [ ]	指定されたインデックス位置にある要素を設定または取得します。

解説

CByteArrayには、要素のシリアル化とダンプをサポートする IMPLEMENT_Standard Edition RIAL マクロが組み込まれています。 オーバーロードされた挿入 ( <<) 演算子または Serialize メンバー関数を使用して、バイトの配列がアーカイブに格納されている場合、各要素はシリアル化されます。

Note

配列を使用する前に、SetSize を使用してそのサイズを設定し、メモリを割り当てます。 SetSize を使用しない場合、配列に要素を追加すると、配列の再割り当てとコピーが頻繁に発生します。 頻繁な再割り当てとコピーは非効率であり、メモリが断片化される可能性があります。

配列内の個々の要素からのデバッグ出力が必要な場合は、オブジェクトの CDumpContext 深さを 1 以上に設定する必要があります。

使用CByteArrayの詳細については、コレクションに関する記事を参照してください。

継承階層

CObject

CByteArray

必要条件

ヘッダー: afxcoll.h

関連項目

CObject クラス
階層図
CObArray クラス