System.Classes.TStream.Read
Delphi
function Read(var Buffer; Count: Longint): Longint; overload; virtual;
function Read(Buffer: TBytes; Offset, Count: Longint): Longint; overload; virtual;
function Read(var Buffer: TBytes; Count: Longint): Longint; overload;
C++
virtual int __fastcall Read(void *Buffer, int Count)/* overload */;
virtual int __fastcall Read(System::DynamicArray<System::Byte> Buffer, int Offset, int Count)/* overload */;
int __fastcall Read(System::DynamicArray<System::Byte> &Buffer, int Count)/* overload */;
プロパティ
| 種類 | 可視性 | ソース | ユニット | 親 |
|---|---|---|---|---|
| function | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStream |
説明
ストリームから Buffer へ、データを Count バイトまで読み込み処理をするメソッド。
下位のストリーム クラスは、自分自身の Read メソッドを定義することができ、そのメソッドでは、特定の記録媒体（メモリやディスク ファイルなど）から、バッファ Buffer へ、データを読み込みます。
Read は、ストリームから読み込むバイト数が固定される必要がないクラスで使用されます。
Read は、ストリームから Buffer へ、Count バイトになるまで読み込みを試行します。その際、現在の位置から開始し、実際に転送されるバイト数文、ストリーム内の現在の位置まで進みます。Read は、実際に読み込まれたバイト数を返します。これは、Count よりも小さいこともあります。
Offset は、Buffer に最初のバイトを書き込む、Buffer 内の 0 始まりの位置を示します。
ストリームのその他のデータ読み込みメソッド（ReadBuffer、ReadData）はすべて、実際の読み込みを行うために Read を呼び出します。