file_find_first()

Game Maker Language リファレンス > 組み込み関数 用途別 > ファイル操作・レジストリ・シェル機能・コマンドライン関連 > file_find_first

file_find_first() †

• 対応：5.3A 6.0 6.1A 7.0
• lite OK

書式 †

file_find_first(mask,attr)

mask

検索対象となるファイルの文字列

attr

検索対象となるファイルの属性

戻り値 †

string

検索対象に一致した場合、そのファイル/フォルダ名。一致しなかった場合は空の文字列。

機能 †

引数 mask に一致するファイルを検索します。
検索対象のファイルが存在すると、最初に一致したファイル名の文字列を返します。
引数 mask には、ワイルドカードが使用できます。~

'*'

0字以上の任意の文字列に一致

'?'

1字の任意の文字に一致

引数 attr には、次の属性を検索対象に含める場合に指定します。
特に指定しない場合は 0 を指定します。

fa_readonly

読み取り専用ファイル

fa_hidden

隠し属性のファイル

fa_sysfile

システムファイル

fa_volumeid

ボリューム

fa_directory

ディレクトリ

fa_archive

アーカイブ属性のファイル

ファイル検索が終了し、結果が必要なくなったらfile_find_close()を呼び出してください。

例 †

textfilename = file_find_first("*.txt",0);  // 任意の.txtファイルに一致するものを検索する。
file_find_close();