InfoFile() 関数InfoFile()かんすう

ファイルまたはディレクトリのさまざまな情報を返します。

構文

result = InfoFile (filename, infotype, trigger)

パラメータ

filename

情報を取得するフル ファイル名またはディレクトリ名です。リテラル文字列値、メッセージ型タグ名、または文字列式です。"*" および "?" などのワイルドカード文字を含めることもできます。

infotype

指定ファイルまたはディレクトリについて取得する情報のタイプです。リテラル整数値、整数型タグ名、または整数式です。値と意味は以下のとおりです。

1 - 存在。InfoFile() 関数は、ファイルが存在する場合は 1、ファイルがディレクトリの場合は 2、ファイルまたはディレクトリが存在しない場合は 0 を返します。

2 - サイズ。ファイルのサイズをバイト単位で返します。

3 - 作成タイムスタンプ。InfoFile() 関数は、タイムスタンプを 1970 年 1 月 1日の真夜中以降に経過した秒数として返します。StringFromTimeLocal() 関数を使用すると、この値をメッセージ タイムスタンプに変換できます。

4 - ワイルドカード検索一致。InfoFile() 関数は、指定したワイルドカード検索に一致するファイル数を返します。

trigger

ファイル情報を再計算するトリガとして機能するタグ名（または式）です。トリガ値が変わると、ファイル情報が再計算されます。論理型またはアナログ型のタグ名、または論理型またはアナログ型の式です。

備考

トリガ タグは、InfoFile() 関数がアニメーション表示リンクで使用される場合だけ意味があります。この関数がスクリプトで使用される場合、リテラル数値、アナログ型タグ名または数式を指定できます。

例

このスクリプトは、ファイル c:\data\log.txt が存在する場合 1 を返します。

InfoFile("c:\data\log.txt",1,$minute)

このスクリプトは、ファイル c:\data\log.txt のファイル サイズが 14223 のバイトの場合 14223 を返します。

InfoFile("c:\data\log.txt",2,$minute)

このスクリプトは、ファイル c:\data\log.txt が 2006 年 1 月 26 日 11:14:26 AM に作成された場合 1138245266 を返します。

InfoFile("c:\data\log.txt",3,$minute)

このスクリプトは、c:\data\ ディレクトリに txt で終了するファイルが 14 個ある場合 14 を返します。

InfoFile("c:\data\*.txt",4,$minute)