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.