System.Classes.TReader.ReadChar

提供: RAD Studio API Documentation
移動先: 案内検索

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 を呼び出して値の種類を示すマーカーを読み取ります。値の種類を示すマーカーvaStringvaLStringvaWString、または vaUTF8String であれば、ReadCharRead を呼び出して、指定された型の文字列を読み取ります。その後、ReadChar は、指定された型のちょうど 1 文字だけが文字列に含まれていることを確認し、その文字を返します。そうでなければ、EReadError 例外が発生します。

ReadChar は、リーダーの Position を、読み取った最後のバイトの後の位置へと進めます。

メモ: ReadChar は、タグ付きデータが length = 1 の文字列の場合には、成功とみなされます。length > 1 の場合はエラーになりますが、その場合でも、リーダーの状態の整合性を維持するために、文字列データの残りの部分を読み取る必要があります。タグ付きデータを処理する各アクションでは、まだ読み取られていない次のタグの先頭に、リーダーの Position を設定しておく必要があります。
メモ: vaString 値型インジケータは、ANSIString 型に適用されますが、vaLString 値型は、文字列型のエイリアスである Unicode 文字列型である点に注意してください。

関連項目