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_SERIAL マクロが組み込まれています。 オーバーロードされた挿入 ( <<) 演算子または Serialize メンバー関数を使用して、バイト配列がアーカイブに格納されている場合、各要素はシリアル化されます。
Note
配列を使用する前に、SetSize を使用してそのサイズを設定し、メモリを割り当てます。 SetSize を使用しない場合、配列に要素を追加すると、配列の再割り当てとコピーが頻繁に発生します。 頻繁な再割り当てとコピーは非効率であり、メモリが断片化される可能性があります。
配列内の個々の要素からのデバッグ出力が必要な場合は、 CDumpContext オブジェクトの深さを 1 以上に設定する必要があります。
CByteArrayの使用方法の詳細については、Collectionsに関する記事を参照してください。
継承階層
CByteArray
要件
Header: afxcoll.h