System.Classes.TStream.WriteBuffer
Delphi
procedure WriteBuffer(const Buffer; Count: NativeInt); overload;
procedure WriteBuffer(const Buffer: TBytes; Count: NativeInt); overload;
procedure WriteBuffer(const Buffer: TBytes; Offset, Count: NativeInt); overload;
C++
void __fastcall WriteBuffer(const void *Buffer, NativeInt Count)/* overload */;
void __fastcall WriteBuffer(const System::DynamicArray<System::Byte> Buffer, NativeInt Count)/* overload */;
void __fastcall WriteBuffer(const System::DynamicArray<System::Byte> Buffer, NativeInt Offset, NativeInt Count)/* overload */;
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TStream |
説明
Buffer
からストリームへ Count
バイトを書き込みます。
WriteBuffer は Buffer
からストリーム内の現在位置に Count
バイトを書き込もうと試み、さらに WriteBuffer は現在位置を Count
だけ先に進めます。要求されたバイト数すべてを書き込むことに失敗すると、EWriteError 例外が発生します。
Offset
には、書き込む最初のバイトを、Buffer
内の 0 から始まる位置で指定します。
WriteBuffer を使用して、ストリームへデータを保存することができます。WriteBuffer は、書き込むバイト数が既知でかつ必要である場合(構造体に書き込む場合など)に使用します。WriteBuffer は、標準のファイル I/O ストリーム処理に使用してください。
WriteBuffer は、ストリームへの書き込みに内部的に使われます。文字列やリストなどの他のオブジェクトによって、バッファに格納された文字列を書き込むために使用されます。
WriteBuffer では、Write を呼び出して実際の書き込みを行います。