System.Classes.TReader.ReadListBegin
Delphi
procedure ReadListBegin; inline;
C++
void __fastcall ReadListBegin();
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TReader |
Beschreibung
Liest einen Werttypbezeichner für den Beginn der Liste aus dem Stream des Reader-Objekts.
ReadListBegin wird von anderen Methoden verwendet, die durch eine Liste von Elementen iterieren, um zu prüfen, ob der einzulesende Typ eine Liste ist.
ReadListBegin überprüft, ob es sich beim nächsten Datenelement an der aktuellen Reader-Position im Stream um einen von der Methode WriteListBegin geschriebenen Werttypbezeichner für den Beginn einer Liste vaList
handelt.
ReadListBegin ruft ReadValue auf, um zu überprüfen, ob der Werttypbezeichner vaList
lautet, und dann wird ReadListBegin ausgeführt und die Stream-Position nach dem Werttypbezeichner gesetzt.
Wenn ReadValue nicht vaList
, sondern einen anderen korrekten Werttypbezeichner ermittelt, dann überspringt ReadListBegin die Anzahl der vom erhaltenen Werttypbezeichner angegebenen Bytes und löst eine EReadError-Exception aus.
Ein Aufruf von ReadListBegin steht normalerweise vor dem Eintritt in eine Leseschleife, die abbricht, sobald die Methode EndOfList True
zurückgibt und damit anzeigt, dass an der nächsten Position im String eine Markierung für das Listenende steht, wofür ein Aufruf von ReadListEnd erforderlich ist.