FileExist

ファイルまたはフォルダの存在を確認し、その属性を返します。

AttributeString := FileExist(FilePattern)

パラメータ

FilePattern

型：文字列

チェックするパス、ファイル名、またはファイルパターンを指定します。FilePatternは、絶対パスが指定されない場合、A_WorkingDirにあるとみなされます。

戻り値

型：文字列

この関数は、最初にマッチしたファイルまたはフォルダの属性を返します。この文字列はRASHNDOCTLの部分集合で、各文字は次のような意味を持っています：

• R = READONLY
• A = ARCHIVE
• S = SYSTEM
• H = HIDDEN
• N = NORMAL
• D = DIRECTORY
• O = OFFLINE
• C = COMPRESSED
• T = TEMPORARY
• L = REPARSE_POINT（通常はシンボリックリンク）

ファイルに属性がない場合（稀）には、"X"が返されます。ファイルやフォルダが見つからない場合は、空の文字列が返されます。

備考

Note that a wildcard check like InStr(FileExist("MyFolder\*"), "D") with MyFolder containing files and subfolders will only tell you whether the first matching file is a folder, not whether a folder exists. To check for the latter, use DirExist, e.g. DirExist("MyFolder\*").

FileGetAttribとは異なり、FileExistはワイルドカードパターンをサポートし、一致するファイルが存在する場合は常に空でない値を返します。

空文字列は "false"とみなされるため、この関数の戻り値は常に準ブール値として使用することができる。例えば、if FileExist("C:\My File.txt")という文は、ファイルが存在すれば真、そうでなければ偽となります。

FilePatternはワイルドカードを含むことができるので、FileExistは他の関数やプログラムで使用するファイルパスの検証には適さないかもしれません。例えば、FileExist("*.txt")は、"*.txt "が有効なファイル名でないにもかかわらず、属性を返す場合があります。このような場合は、FileGetAttribを使用することが望ましい。

関連

DirExist、FileGetAttrib、ファイルループ

例

if FileExist("D:\")
    MsgBox "The drive exists."

if FileExist("D:\Docs\*.txt")
    MsgBox "At least one .txt file exists."

if not FileExist("C:\Temp\FlagFile.txt")
    MsgBox "The target file does not exist."

if InStr(FileExist("C:\My File.txt"), "H")
    MsgBox "The file is hidden."