filereadln
2023/09/18 15:54
filereadln 機能
[ファイル操作コマンド]ファイルから一行読みます。
コマンドライン
filereadln <file handle> <strvar>
機能説明
開いているファイル *1 から、ファイルポインタのある行を1行読み込みます。読み込み完了時、ファイルポインタを次の行へ移動しておきます。
Tera Term バージョン 4.102 より、マクロファイルのエンコーディングとして UTF-8 および UTF-16 (いずれも BOM の有無はチェック) に対応しているものの、filereadln はどちらにも未対応のため、対象ファイルが UTF-8 または UTF-16 の場合に文字化けします。
※ Tera Term バージョン 4.103 にて確認。
なお、文字化けすると記載しましたが、SJIS でも UTF-8 でも ASCII 部分は同一です。そのため、UTF-8 のファイルであっても、英数字部分は問題なく読み込むことが可能です。
<file handle>
ファイルハンドル <file handle> で指定されるファイルから一行読みます。この時の対象となる行（読む行）は、ファイルポインタで指示された行です。
<strvar>
読み込んだ行は、文字列変数 <strvar> に格納します。ファイルポインタは次の行の始めへ移動します。
もし、行を読んでいる間にファイルポインタがファイルの最後に達した場合、システム変数 <result> に 1 が格納されます。
それ以外の場合、<result> に 0 が格納されます。
改行のみの場合は、文字列変数は空となり、<result> には 0 が格納されます。
パラメータの説明
指定するパラメータは以下の通りです。| パラメータ | 型 | パラメータ説明 |
|---|---|---|
| <file handle> | 整数 | ファイルハンドルを指定します。 |
| <strvar> | 文字列 | 読み込んだ行を格納する変数名を指定します。 |