System.Classes.TMemoryStream.Write

• 親: TMemoryStream

Delphi

function Write(const Buffer; Count: TNativeCount): TNativeCount; override;

C++

virtual TNativeCount __fastcall Write(const void *Buffer, TNativeCount Count)/* overload */;
inline System::LongInt __fastcall  Write(const System::Sysutils::TBytes Buffer, System::LongInt Offset, System::LongInt Count){ return TStream::Write(Buffer, Offset, Count); }
inline System::LongInt __fastcall  Write(const System::Sysutils::TBytes Buffer, System::LongInt Count){ return TStream::Write(Buffer, Count); }

プロパティ

種類	可視性	ソース	ユニット	親
function	public	System.Classes.pas System.Classes.hpp	System.Classes	TMemoryStream

説明

Write メソッドは，Buffer から Count バイトのデータをメモリバッファの現在の位置に書き込み，Count バイト分だけ現在の位置を更新します。

Write メソッドを呼び出すと，Count バイトのデータをメモリストリームのメモリバッファの現在の位置から書き込むことができます。Write メソッドは，必要であればメモリバッファのサイズを増やしてデータを書き込みます。現在の位置がメモリバッファの最後ではない場合，Write メソッドは現在の位置以降のデータに上書きします。

Write は，Size プロパティを Position + Count に更新し，Position プロパティを Size の新しい値に設定します。そのため，メモリストリームで現在の位置から Count バイトに格納されていたすべてのデータは，Write メソッドの呼び出しで失われます。

Write メソッドは，メモリエラーがなければ必ず Count バイトのデータを Buffer に書き込みます。したがって，TMemoryStream オブジェクトでは，Write メソッドは WriteBuffer メソッドと同じ働きのメソッドです。

メモリストリームのほかのデータ書き込みメソッド（WriteBuffer，WriteComponent）は Write メソッドを呼び出して実際にデータを書き込みます。

関連項目

• Memory

• Position

• Size

• WriteBuffer

• WriteComponent