System.Classes.TStream.Read
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 */;
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | System.Classes.pas System.Classes.hpp |
System.Classes | TStream |
Description
Méthodes responsables de la lecture de jusqu'à Count octets de données à partir du flux dans Buffer.
Les classes de flux descendantes peuvent définir leur propre méthode Read pour lire les données depuis un support de stockage particulier (comme la mémoire ou un fichier disque) dans un tampon Buffer.
Read est utilisée quand le nombre d'octets à lire dans le flux n'est pas nécessairement fixé.
Read tente de lire, dans Buffer, jusqu'à Count octets depuis le flux, en commençant à la position en cours, puis en avançant la position en cours dans le flux du nombre d'octets réellement transférés. Read renvoie le nombre d'octets réellement lus, qui peut être inférieur à Count.
Offset spécifie une position basée sur 0 dans Buffer à partir de laquelle écrire le premier octet dans Buffer.
Toutes les autres méthodes de lecture de données des flux (ReadBuffer, ReadData) appellent Read pour effectuer réellement la lecture.