System.Classes.TMemoryStream.Write

• 親: TMemoryStream

Delphi

function Write(const Buffer; Count: Longint): Longint; override;
function Write(const Buffer: TBytes; Offset, Count: Longint): Longint; override;

C++

virtual int __fastcall Write(const void *Buffer, int Count)/* overload */;
virtual int __fastcall Write(const System::DynamicArray<System::Byte> Buffer, int Offset, int Count)/* overload */;
inline int __fastcall  Write(const System::DynamicArray<System::Byte> Buffer, int 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