【Tera Term マクロ言語】コマンドリファレンス
[ファイル操作コマンド]
ファイルを開きます。
fileopen <file handle> <file name> <append flag> [<readonly flag>]
ファイルをバイナリモードでオープンします。
ファイルが存在しない場合は、新たに作成してからオープンします。
なお、バージョン 4.102 および 4.103 では、ファイルが開けなかった場合にエラー終了します。
他のファイルハンドルを利用するコマンドに渡せるファイルハンドルを指定します。
閉じないままファイルを開くごとに、別のファイルハンドルを指定する必要があります。
ファイルハンドルで利用するファイル名を指定します。
<append flag> に指定する数値は、以下の通りです。
| <append flag> | 数値の意味 |
|---|
| 0 | ファイルポインタ (読み書きの現在位置) が、ファイルの始めにセットされます。 |
| 0以外 | ファイルポインタが、ファイルの最後にセットされます。 |
バージョン 4.85 以降、[<readonly flag>] の指定内容は、以下の通りです。
| [<readonly flag>] | 数値の意味 |
|---|
| 省略 | 読み書きモードでファイルを開きます。 |
| 0 | 読み書きモードでファイルを開きます。 |
| 0以外 | 読み取り専用モードでファイルを開きます。 |
指定するパラメータは以下の通りです。
| パラメータ | 型 | パラメータ説明 |
|---|
| <file handle> | 整数 | ファイルハンドル名を指定します。 |
| <file name> | 文字列 | オープンするファイル名を指定します。 |
| <append flag> | 整数 | ファイルポインタの位置を意味する整数を指定します。 |
| <readonly flag> | 整数 | 読み書きモード/読み取り専用モードを指定します。 |
一部機能は、全てのバージョンで利用可能です。
バージョン 4.85 より追加された機能があります。
戻り値として以下の変数が定義されます。
| 変数名 | 値 | 意味 |
|---|
| <file handle> | -1 | ファイルが正しくオープンされなかった |
| 0 | ファイルハンドルが格納された |
・ファイルポインタをファイルの始めにセットしてオープンする場合
fileopen fhandle 'data.dat' 0
・ファイルポインタをファイルの最後にセットしてオープンする場合
fileopen fhandle 'data.dat' 1
・バッチファイルを作成および実行する場合
fileopen fhandle 'test.bat' 0
filewrite fhandle 'md .\v20080619_Test'
fileclose fhandle
pause 5
exec 'cmd /c test.bat'
pause 10
end
以下のサンプルが存在します。
| バージョン | バグ情報 | 備考 |
|---|
| 対象 | Fix |
|---|
| - | 4.106 | マクロコマンドで開いたファイルハンドルがロックしている問題が修正されました。 | |
2024/03/06 14:42