System.Classes.TStream.Read

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function Read(var Buffer; Count: Longint): Longint; overload; virtual;
function Read(Buffer: TBytes; Offset, Count: Longint): Longint; overload; virtual;
function Read(var Buffer: TBytes; Count: Longint): Longint; overload;

C++

virtual int __fastcall Read(void *Buffer, int Count)/* overload */;
virtual int __fastcall Read(System::DynamicArray<System::Byte> Buffer, int Offset, int Count)/* overload */;
int __fastcall Read(System::DynamicArray<System::Byte> &Buffer, int Count)/* overload */;

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
System.Classes.pas
System.Classes.hpp
System.Classes TStream


Beschreibung

Methoden, die für das Einlesen von bis zu Count Byte von Daten aus dem Stream in Buffer zuständig sind.

Abgeleitete Stream-Klassen definieren ihre eigenen Read-Methoden, die Daten vom jeweiligen Speichermedium (wie Arbeitsspeicher oder Festplattendatei) in einen Buffer-Puffer einlesen.

Read wird für Fälle verwendet, bei denen die Anzahl der aus dem Stream zu lesenden Bytes nicht notwendigerweise festgelegt sein muss.

Read versucht, beginnend bei der aktuellen Position bis zu Count Byte aus dem Stream in Buffer zu lesen und setzt dann die aktuelle Position im Stream um die Anzahl der übertragenen Bytes nach vorne. Read gibt die Anzahl der tatsächlich gelesenen Bytes zurück, die weniger als Count sein kann.

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

Alle anderen Methoden des Speicher-Streams, die das Lesen von Daten ermöglichen (ReadBuffer, ReadData) rufen zum Lesen Read auf.

Siehe auch