System.Classes.TStream.ReadBuffer
Delphi
procedure ReadBuffer(var Buffer; Count: NativeInt); overload;
procedure ReadBuffer(var Buffer: TBytes; Count: NativeInt); overload;
procedure ReadBuffer(var Buffer: TBytes; Offset, Count: NativeInt); overload;
C++
void __fastcall ReadBuffer(void *Buffer, NativeInt Count)/* overload */;
void __fastcall ReadBuffer(System::DynamicArray<System::Byte> &Buffer, NativeInt Count)/* overload */;
void __fastcall ReadBuffer(System::DynamicArray<System::Byte> &Buffer, NativeInt Offset, NativeInt Count)/* overload */;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TStream |
説明
ストリームから Count バイト分を読み取り、Buffer に格納します。
読み取るバイト数が既知で固定の場合（たとえば、構造体を読み取る場合など）、ReadBuffer を使用すると、ストリームから Count バイト分を読み取って Buffer バッファに格納できます。ReadBuffer は、ストリームからの読み込みやストリームからのコピーに内部的に使用されます。
Read では、ストリームの現在位置を起点に、ストリームからちょうど Count バイト分の読み取りを試みたあと、ストリーム内の現在位置を、実際に転送されたバイト数だけ進めます。
Offset では、Buffer へのバイト データの書き込みを開始する位置をゼロを起点として指定します。
ReadBuffer では、Read を呼び出して実際の読み取りを行います。Count バイト分をストリームから読み取れない場合は、EReadError 例外が発生します。