System.Classes.TReader.ReadListBegin
Delphi
procedure ReadListBegin; inline;
C++
void __fastcall ReadListBegin();
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TReader |
Description
Lit un indicateur de type de valeur de début de liste dans le flux de l'objet lecteur.
La méthode ReadListBegin est utilisée par d'autres méthodes qui parcourent une liste d'éléments pour vérifier que le type qui va être lu est une liste.
ReadListBegin vérifie que l'élément de données suivant à la position en cours du lecteur dans le flux est un indicateur de type de valeur de début de liste vaList
tel qu'écrit par la méthode WriteListBegin.
ReadListBegin appelle ReadValue pour vérifier que l'indicateur de type de valeur est vaList
, puis ReadListBegin réussit et avance la position du flux après l'indicateur de type de valeur.
Si ReadValue récupère un indicateur de type de valeur autre que vaList
mais toutefois correct, ReadListBegin ignore alors le nombre d'octets spécifiés par l'indicateur de type de valeur obtenu et déclenche une exception EReadError.
Généralement, l'appel de ReadListBegin est suivi d'une boucle de lecture qui s'arrête quand la méthode EndOfList renvoie True
, ce qui indique que le marqueur de fin de liste est le prochain élément du flux. A ce stade, il est nécessaire d'appeler ReadListEnd.