System.Classes.TReader.ReadListEnd

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

procedure ReadListEnd; inline;

C++

void __fastcall ReadListEnd();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
procedure
function
public
System.Classes.pas
System.Classes.hpp
System.Classes TReader


Beschreibung

Liest einen Werttypbezeichner für das Ende der Liste aus dem Stream des Reader-Objekts.

ReadListEnd wird von anderen Methoden verwendet, die durch eine Liste von Elementen iterieren, um anzuzeigen, dass das Ende einer Gruppe von gelesenen Elementen erreicht wurde.

ReadListEnd überprüft, ob es sich beim nächsten Datenelement an der aktuellen Stream-Position um einen von der Methode WriteListEnd geschriebenen Werttypbezeichner für das Ende einer Liste vaNull handelt.

ReadListEnd ruft ReadValue auf, um zu überprüfen, ob der Werttypbezeichner vaNull lautet, und dann wird ReadListEnd ausgeführt und die Stream-Position nach dem Werttypbezeichner gesetzt.

Wenn ReadValue nicht vaNull, sondern einen anderen korrekten Werttypbezeichner ermittelt, dann überspringt ReadListEnd die Anzahl der vom erhaltenen Werttypbezeichner angegebenen Bytes und löst eine EReadError-Exception aus.

ReadListEnd wird nach einer Leseschleife aufgerufen, die abbricht, sobald die Methode EndOfList True zurückgibt und damit anzeigt, dass eine Markierung für das Listenende als nächstes Element im Stream steht.

Ein Aufruf von ReadListEnd muss einem vorausgegangenen Aufruf von ReadListBegin entsprechen.

Siehe auch