Ξ
Δ
◄
►
¬
Ѕ
フィルター
ディレクティブ
組み込みの変数
組み込み関数
制御フロー文
演算子
宣言
組み込みクラス
組み込みメソッド／プロパティ
Ahk2Exeコンパイラ
キーワードをハイライト
</head> <body> <h1>FileExist</h1> <p>ファイルまたはフォルダの存在を確認し、その属性を返します。</p> <pre class="Syntax">AttributeString := <span class="func">FileExist</span>(FilePattern)</pre> <h2 id="Parameters">パラメータ</h2> <dl> <dt>FilePattern</dt> <dd> <p>型：<a href="../Concepts.htm#strings">文字列</a></p> <p>チェックするパス、ファイル名、またはファイルパターンを指定します。<em>FilePattern</em>は、絶対パスが指定されない場合、<a href="../Variables.htm#WorkingDir">A_WorkingDir</a>にあるとみなされます。</p> </dd> </dl> <h2 id="Return_Value">戻り値</h2> <p>型：<a href="../Concepts.htm#strings">文字列</a></p> <p>この関数は、最初にマッチしたファイルまたはフォルダの属性を返します。この文字列は<code>RASHNDOCTL</code>の部分集合で、各文字は次のような意味を持っています：</p> <ul> <li>R = READONLY</li> <li>A = ARCHIVE</li> <li>S = SYSTEM</li> <li>H = HIDDEN</li> <li>N = NORMAL</li> <li>D = DIRECTORY</li> <li>O = OFFLINE</li> <li>C = COMPRESSED</li> <li>T = TEMPORARY</li> <li>L = REPARSE_POINT（通常はシンボリックリンク）</li> </ul> <p>ファイルに属性がない場合（稀）には、"X"が返されます。ファイルやフォルダが見つからない場合は、空の文字列が返されます。</p> <h2 id="Remarks">備考</h2> <p>Note that a wildcard check like <code>InStr(FileExist("MyFolder\*"), "D")</code> with <em>MyFolder</em> containing files and subfolders will only tell you whether the <u>first</u> matching file is a folder, not whether a folder exists. To check for the latter, use <a href="DirExist.htm">DirExist</a>, e.g. <code>DirExist("MyFolder\*")</code>.</p> <p><a href="FileGetAttrib.htm">FileGetAttrib</a>とは異なり、FileExistはワイルドカードパターンをサポートし、一致するファイルが存在する場合は常に空でない値を返します。</p> <p>空文字列は "false"とみなされるため、この関数の戻り値は常に準ブール値として使用することができる。例えば、<code>if FileExist("C:\My File.txt")</code>という文は、ファイルが存在すれば真、そうでなければ偽となります。</p> <p><em>FilePattern</em>はワイルドカードを含むことができるので、FileExistは他の関数やプログラムで使用するファイルパスの検証には適さないかもしれません。例えば、<code>FileExist("*.txt")</code>は、"*.txt "が有効なファイル名でないにもかかわらず、属性を返す場合があります。このような場合は、<a href="FileGetAttrib.htm">FileGetAttrib</a>を使用することが望ましい。</p> <h2 id="Related">関連</h2> <p><a href="DirExist.htm">DirExist</a>、<a href="FileGetAttrib.htm">FileGetAttrib</a>、<a href="LoopFiles.htm">ファイルループ</a></p> <h2 id="Examples">例</h2> <div class="ex" id="ExDrive"> <p><a class="ex_number" href="#ExDrive"></a> Dドライブが存在する場合、メッセージボックスを表示します。</p> <pre>if FileExist("D:\") MsgBox "The drive exists."</pre> </div> <div class="ex" id="ExPattern"> <p><a class="ex_number" href="#ExPattern"></a> ディレクトリに少なくとも1つのテキストファイルが存在する場合、メッセージボックスを表示します。</p> <pre>if FileExist("D:\Docs\*.txt") MsgBox "At least one .txt file exists."</pre> </div> <div class="ex" id="ExNot"> <p><a class="ex_number" href="#ExNot"></a> ファイルが存在<u>しない</u>ときは、メッセージボックスを表示します。</p> <pre>if not FileExist("C:\Temp\FlagFile.txt") MsgBox "The target file does not exist."</pre> </div> <div class="ex" id="ExAttr"> <p><a class="ex_number" href="#ExAttr"></a> 特定の属性のファイルをチェックする方法を説明します。</p> <pre>if InStr(FileExist("C:\My File.txt"), "H") MsgBox "The file is hidden."</pre> </div> </body> </html>