System.Classes.TReader.ReadChar
Delphi
function ReadChar: Char;
C++
System::WideChar __fastcall ReadChar();
プロパティ
種類 | 可視性 | ソース | ユニット | 親 |
---|---|---|---|---|
function | public | System.Classes.pas System.Classes.hpp |
System.Classes | TReader |
説明
リーダー オブジェクトのストリームから 1 文字を読み取って返します。
ReadChar は、現在のリーダーの Position にある 1 つの文字を読み取るために他のリーダー メソッドが使用する、ヘルパ メソッドです。ReadChar は、ReadValue を呼び出して値の種類を示すマーカーを読み取ります。値の種類を示すマーカーが vaString
、vaLString
、vaWString
、または vaUTF8String
であれば、ReadChar は Read を呼び出して、指定された型の文字列を読み取ります。その後、ReadChar は、指定された型のちょうど 1 文字だけが文字列に含まれていることを確認し、その文字を返します。そうでなければ、EReadError 例外が発生します。
ReadChar は、リーダーの Position を、読み取った最後のバイトの後の位置へと進めます。
メモ: ReadChar は、タグ付きデータが
length = 1
の文字列の場合には、成功とみなされます。length > 1
の場合はエラーになりますが、その場合でも、リーダーの状態の整合性を維持するために、文字列データの残りの部分を読み取る必要があります。タグ付きデータを処理する各アクションでは、まだ読み取られていない次のタグの先頭に、リーダーの Position を設定しておく必要があります。メモ:
vaString
値型インジケータは、ANSIString
型に適用されますが、vaLString
値型は、文字列型のエイリアスである Unicode 文字列型である点に注意してください。