findnext

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

findnext 機能

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

文字列に合致する次のファイルを探します。

コマンドライン

findnext <dir handle> <strvar>

機能説明

findnext コマンドは、すでに実行している findfirst コマンドで指定されたファイル名に合致する、次のファイルを探します。
<dir handle>
整数値 <dir handle> は findfirst コマンドで得られたディレクトリハンドルでなければなりません。
<strvar>
もし次のファイルが見つかった場合、<strvar> にファイル名が格納され、<result> に 1 が格納されます。

それ以外の場合は、<strvar><result> にそれぞれ "" と 0 が格納されます。

パラメータの説明

指定するパラメータは以下の通りです。
パラメータパラメータ説明
<dir handle>整数ディレクトリハンドルを指定します。
<strvar>文字列見つけたファイル名を格納する変数を指定します。

対象バージョン

全てのバージョンで利用可能です。

戻り値

戻り値として以下の変数が定義されます。
変数名意味
result0ファイルが見つけられなかった
1ファイルが見つかった
<strvar>文字列見つけたファイル名
<strvar> は、コマンド実行時に指定した任意の文字列です。

関連コマンド

種別:ファイル操作Ver機能の簡易説明
0175文字列に合致する最初のファイルを探す。
0177ディレクトリハンドルを解放する。

使用方法

使用例

・ファイル名を検索する場合
extpat='*.txt'
findfirst dh extpat filename

while result
	messagebox filename extpat
	findnext dh filename
endwhile

findclose dh

サンプル

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

備考

特にありません。