System.Classes.TStream.CopyFrom

Delphi

function CopyFrom(const Source: TStream; Count: Int64): Int64;

C++

__int64 __fastcall CopyFrom(TStream* const Source, __int64 Count);

説明

指定したバイト数を別のストリームにコピーします。

CopyFrom メソッドを使用すると、データを別のストリームにコピーできます。 CopyFrom を使用することで、データをコピーするときにバッファの作成、読み書き、および解放を行う必要がなくなります。

CopyFrom は、Source が指定するストリームの Count バイトを別のストリームにコピーします。そして現在の位置を Count で指定するバイト数だけ移動し、コピーしたバイト数を返します。

Count が 0 の場合、CopyFrom は Source 位置を 0 に設定してからデータを読み出し、Source の内容をすべてストリームにコピーします。 Count の値が 0 以外の場合、CopyFrom は Source の現在位置からデータを読み出します。

CopyFrom メソッドは ReadBuffer および WriteBuffer メソッドを使用して効果的なコピーを行うため、 Count が SourceStream の指定するサイズよりも大きい場合、ReadBuffer がストリームの読み込みエラーが起こったことを示す例外を送出します。