24.6.6 Locating Files in Standard Places

このセクションでは、ディレクトリーのリスト(パス(path))からファイルを検索したり、標準の実行可能ファイル用ディレクトリーから実行可能ファイルを検索する方法を説明します。

ユーザー固有の設定ファイル(configuration file)の検索については、Standard File Namesの関数locate-user-emacs-fileを参照してください。

Function: locate-file filename path &optional suffixes predicate

この関数は、pathで与えられるディレクトリーリスト内で、filenameという名前のファイルを検索して、suffixes内のサフィックスの検索を試みる。そのようなファイルが見つかった場合はファイルの絶対ファイル名(Relative File Namesを参照)をリターンし、それ以外はnilをリターンする。

オプション引数suffixesは、検索時にfilenameに追加するファイル名サフィックスのリストを与える。locate-fileは、検索するディレクトリーごとに、それらのサフィックスを試みる。suffixesがnil、または("")の場合は、サフィックスなしで、filenameだけがそのまま使用される。suffixesの典型的な値はexec-suffixes(Subprocess Creationを参照)、load-suffixes、load-file-rep-suffixes、および関数get-load-suffixes(Load Suffixesを参照)である。

実行可能プログラムを探すときはexec-path(Subprocess Creationを参照)、Lispファイルを探すときはload-path(Library Searchを参照)がpathの典型的な値である。filenameが絶対ファイル名の場合、pathは効果がないが、サフィックスにたいするsuffixesは依然として試行される。

オプション引数predicateが非nilの場合、それは候補ファイルが適切かどうかテストする述語関数を指定する。述語関数には、単一の引数として候補ファイル名が渡される。predicateがnil、または省略された場合は、述語としてfile-readable-pを使用する。file-executable-pやfile-directory-pなど、その他の有用な述語については、Kinds of Filesを参照のこと。

互換性のために、predicateにはexecutable、readable、writable、exists、またはこれらシンボルの1つ以上のリストも指定できる。

Function: executable-find program

この関数は、programという名前の実行可能ファイルを検索して、その実行可能ファイルの絶対ファイル名と、もしあればファイル名の拡張子も含めてリターンする。ファイルが見つからない場合は、nilをリターンする。この関数は、exec-path内のすべてのディレクトリーを検索し、exec-suffixes内のすべてのファイル名拡張子の検索も試みる(Subprocess Creationを参照)。