System.Classes.TStream.ReadBuffer

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure ReadBuffer(var Buffer; Count: NativeInt); overload;
procedure ReadBuffer(var Buffer: TBytes; Count: NativeInt); overload;
procedure ReadBuffer(var Buffer: TBytes; Offset, Count: NativeInt); overload;

C++

void __fastcall ReadBuffer(void *Buffer, NativeInt Count)/* overload */;
void __fastcall ReadBuffer(System::DynamicArray<System::Byte> &Buffer, NativeInt Count)/* overload */;
void __fastcall ReadBuffer(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

Liest Count Byte aus dem Stream in den Buffer ein.

Mit ReadBuffer wird die in Count angegebene Byte-Anzahl aus dem Stream in einen Buffer eingelesen, wenn die zu lesende Byte-Anzahl bekannt und nicht variabel ist, beispielsweise beim Einlesen von Strukturen. Intern wird ReadBuffer zum Laden und Kopieren aus einem Stream verwendet.

Read versucht, genau Count Byte aus dem Stream, beginnend bei der aktuellen Position zu lesen, und verschiebt dann die aktuelle Position im Stream um die Anzahl der übertragenen Bytes nach vorne.

Offset gibt die nullbasierte Position in Buffer an, ab der das erste Byte in Buffer geschrieben werden soll.

ReadBuffer ruft für die eigentliche Leseoperation Read auf. Falls nicht Count Byte aus dem Stream gelesen werden können, wird eine EReadError-Exception ausgelöst.

Siehe auch

Codebeispiele