System.Classes.TReader.ReadListBegin

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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.

Siehe auch