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 */;
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TStream |
Beschreibung
Schreibt Count
Byte aus Buffer
in den Stream.
WriteBuffer versucht, Count
Byte aus Buffer
in die aktuelle Position im Stream zu schreiben, und dann setzt WriteBuffer die aktuelle Position um Count
nach vorne. Falls der Stream nicht alle erforderlichen Bytes schreibt, wird eine EWriteError-Exception ausgelöst.
Offset
gibt die nullbasierte Position in Buffer
an, an der das erste Byte geschrieben werden soll.
Mit WriteBuffer können Sie Daten in einem Stream speichern. WriteBuffer wird verwendet, wenn die Anzahl der zu schreibenden Bytes bekannt ist und eingehalten werden muss, beispielsweise beim Schreiben von Strukturen. Verwenden Sie WriteBuffer für Standard-Stream-Operationen (Dateieingaben und -ausgaben).
WriteBuffer wird intern zum Schreiben in einen Stream verwendet. Die Methode wird von anderen Objekten, wie Strings und Listen, verwendet, um in einem Puffer gespeicherte Strings zu schreiben.
WriteBuffer ruft Write auf, um den eigentlichen Schreibvorgang auszuführen.