System.Classes.TReader.ReadListEnd
Delphi
procedure ReadListEnd; inline;
C++
void __fastcall ReadListEnd();
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 fin de liste dans le flux de l'objet lecteur.
La méthode ReadListEnd est utilisée par d'autres méthodes qui parcourent une liste d'éléments pour signaler la fin d'un groupe d'éléments lus.
ReadListBegin vérifie que l'élément de données suivant à la position en cours du lecteur dans le flux en cours est un indicateur de type de valeur de fin de liste vaNull tel qu'écrit par la méthode WriteListBegin.
ReadListEnd appelle ReadValue pour vérifier que l'indicateur de type de valeur est vaNull, puis ReadListEnd 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 vaNull mais toutefois correct, ReadListEnd ignore alors le nombre d'octets spécifiés par l'indicateur de type de valeur obtenu et déclenche une exception EReadError.
L'appel de ReadListEnd est précédé 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.
Un appel de ReadListEnd doit correspondre à un appel antérieur de ReadListBegin.