System.Classes.TReader.ReadListBegin
Delphi
procedure ReadListBegin; inline;
C++
void __fastcall ReadListBegin();
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
procedure function |
public | System.Classes.pas System.Classes.hpp |
System.Classes | TReader |
説明
値の種類を示すマーカーのうち、リストの開始を示すものをリーダー オブジェクトのストリームから読み取ります。
ReadListBegin は、項目のリストを反復処理する他のメソッドで使用されて、読み取ろうとしているデータの種類がリストであることを保証します。
ReadListBegin では、リーダーのストリーム内の現在の Position にある次のデータ項目が、WriteListBegin メソッドで書き込まれるリスト開始マーカー vaList
かどうかを確認します。
ReadListBegin では、ReadValue を呼び出して、値の種類を示すマーカーが vaList
かどうかを確認します。そうであれば、ReadListBegin は成功し、ストリーム内の現在位置をそのマーカーの次へ進めます。
ReadValue で取得されたものが、値の種類を示すマーカーとしては正しいが vaList
ではない場合、ReadListBegin では、取得したマーカーで指定されるバイト数の分だけ読み飛ばし、EReadError 例外を発生させます。
ReadListBegin の呼び出しの後には、通常、読み取りループが実行されます。このループは、EndOfList メソッドの戻り値が True
のときに終了しますが、このときは、ストリーム内の次の項目がリスト終了マーカーであり、この時点で ReadListEnd を呼び出す必要があることを示します。