filestat

【Tera Term マクロ言語】コマンドリファレンス

filestat 機能

[ファイル操作コマンド]

ファイルもしくはフォルダの統計情報を取得します。

コマンドライン

filestat <file name> <size> [<mtime>] [<drive>]

機能説明

ファイルもしくはフォルダ <file name> の統計情報を取得します。
<file name>
統計情報を取得したいファイルもしくはフォルダを指定します。
<size>
取得した統計情報のうち、ファイルサイズを <size> に格納します。
[<mtime>]
取得した統計情報のうち、ファイルもしくはフォルダの最終変更時間を <mtime> に格納します。
[<drive>]
取得した統計情報のうち、ファイルもしくはフォルダのドライブ番号を <drive> に格納します。

パラメータの説明

指定するパラメータは以下の通りです。
パラメータパラメータ説明
<file name>文字列対象ファイルを指定します。
<size>整数サイズを格納する変数名を指定します。
<mtime>文字列最終変更時間を格納する変数名を指定します。
<drive>文字列対象のドライブ番号を格納する変数名を指定します。

対象バージョン

バージョン 4.66 以降で利用可能です。

戻り値

戻り値として以下の変数が定義されます。
変数名意味
result-1取得に失敗した
0取得に成功した
<size>整数対象ファイルのサイズ
<mtime>整数対象の最終変更時間
<drive>整数対象のドライブ番号
<size>, <mtime>, <drive> は、コマンド実行時に指定した任意の文字列です。

関連コマンド

種別:ファイル操作Ver機能の簡易説明
01804.69以降フォルダがあるか確かめる。
01824.69以降ファイルまたはディレクトリの属性を得る。

使用方法

使用例

・対象ファイルの各情報を取得する場合
filestat 'test.exe' size time drive

if result = -1 then
	messagebox 'file open error' 'filestat'
else
	sprintf2 str 'File size=%d Time modified=%s Drive=%s' size time drive
	messagebox str 'filestat'
endif
・対象ディレクトリの各情報を取得する場合
filestat 'Macro' size time drive

if result = -1 then
	messagebox 'Directory open error' 'filestat'
else
	sprintf2 str 'Directory size=%d Time modified=%s Drive=%s' size time drive
	messagebox str 'filestat'
	; ex. Directory size=0 Time modified=2014-03-04 22:44:47 Drive=C
endif

サンプル

サンプルマクロはありません。

備考

特にありません。