System.Classes.TReader.ReadChar

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function ReadChar: Char;

C++

System::WideChar __fastcall ReadChar(void);

Eigenschaften

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


Beschreibung

Liest ein Zeichen aus dem Stream des Reader-Objekts und gibt es zurück.

ReadChar ist eine Hilfsmethode, mit der andere Reader-Methoden ein Zeichen an der aktuellen Reader-Position lesen. ReadChar ruft ReadValue auf, um den Werttypbezeichner zu lesen. Wenn der Werttypbezeichner vaString, vaLString, vaWString oder vaUTF8String lautet, dann ruft ReadChar Read auf, um den String mit dem angegebenen Typ zu lesen. Dann überprüft ReadChar, ob der String exakt ein Zeichen (mit dem angegebenen Typ) enthält und gibt dieses Zeichen zurück. Andernfalls wird die Exception EReadError ausgelöst.

ReadChar setzt den Reader auf die Position nach dem letzten, gelesen Byte.

Hinweis: ReadChar ist erfolgreich, wenn es sich bei den markierten Daten um einen String mit length = 1 handelt. Wenn length > 1 ist, muss auch der Rest der Stringdaten gelesen werden, damit der Reader in einem konsistentem Zustand verbleibt. Jede Aktion, die markierte Daten verarbeitet, muss die Position des Readers an den Anfang des nächsten, noch nicht gelesenen Datenwerts setzen.

Siehe auch