Next: ディレクトリーの作成・コピー・削除, Previous: ファイルの名前, Up: ファイル [Contents][Index]
ディレクトリーとはファイルの一種であり、さまざまな名前のファイルを含んでいます。ディレクトリーはファイルシステムの機能です。
Emacsはディレクトリー内のファイル名をLispのリストとして一覧したり、シェルコマンドls
を使用してバッファー内にファイル名を表示することができます。後者の場合には、Emacsはオプションで各ファイルに関する情報も表示でき、それはls
コマンドに渡すオプションに依存します。
この関数はディレクトリーdirectory内のファイルの名前のリストをリターンする。デフォルトではリストはアルファベット順。
この関数はfull-nameが非nil
ならファイルの絶対ファイル名、それ以外なら指定されたディレクトリーにたいする相対ファイル名をリターンする。
match-regexpが非nil
なら、この関数は非ディレクトリー部分に正規表現へのマッチを含むファイル名だけをリターンして、それ以外のファイル名はリストから除外される。case(大文字小文字)を区別するファイルシステムでは、caseを区別する正規表現マッチングが行われる。
nosortが非nil
ならdirectory-files
はリストをソートしないので、取得するファイル名に特定の順序はない。最大限の可能なスピードを得る必要がありファイル処理順を気にしなければこれを使用する。ユーザーから処理順が可視なら、名前をソートすれば多分ユーザーはより幸せになるだろう。
countが非nil
なら最初のcount個のファイル名、またはすべてのファイル名のいずれか早いほうをリターンする。countは0より大な整数であること。
(directory-files "~lewis") ⇒ ("#foo#" "#foo.el#" "." ".." "dired-mods.el" "files-ja.texi" "files-ja.texi.~1~")
directoryが読み取り可能なディレクトリー名でなければエラーがシグナルされる。
このユーティリティー関数は与えられたdirectoryがアクセス可能なディレクトリーかつ何のファイルも含まない(空ディレクトリー)場合にはt
をリターンする。ディレクトリー内のファイルとして‘.’や‘..’をリターンするシステムでは、それらは無視される。
ディレクトリーへのシンボリックリンクはディレクトリーとみなされる。シンボリックリンクと区別する方法についてはfile-symlink-pを参照のこと。
regexpにマッチする名前をもつdirectory配下のすべてのファイルをリターンする。この関数はベースネーム(basename:
先行するディレクトリー部分を除外したファイル名)がregexpにマッチするファイルを、directoryとそのサブディレクトリーを再帰的に検索して、マッチしたファイルの絶対ファイル名(absolute file
namesを参照)のリストをリターンする。ファイル名は深さ優先順でリターンされ、それは親ディレクトリーの前に任意のサブディレクトリー内のファイルが配置されることを意味する。加えて各ディレクトリー内で見つかったファイルはベースネームにもとづいてソートされる。デフォルトではregexpにマッチする名前のディレクトリーはリストから省略されるが、オプション引数include-directoriesが非nil
ならそれらも含まれる。
デフォルトではすべてのサブディレクトリーが含まれる。predicateがt
ならサブディレクトリーを含める際のエラー(たとえばそのユーザーでは読み取り不可の場合)は無視される。nil
やt
以外なら、1つのパラメーター(サブディレクトリー名)を受け取り、そのディレクトリーを含める場合には非nil
をリターンする関数であること。
デフォルトではサブディレクトリーへのシンボリックリンクはフォローしないが、follow-symlinksが非nil
ならフォローする。
fileから開始してディレクトリーツリー階層を上方にname
(文字列)というディレクトリーを検索して、最初に見つけたディレクトリーをリターンする。fileがファイルならファイルのディレクトリーが検索の開始位置、それ以外ならfileは検索を開始するディレクトリーであること。この関数は開始ディレクトリーを調べて、それからその親ディレクトリー、更にその親ディレクトリー、...のようにnameというディレクトリーを見つけるか、あるいはnameが見つけることなくファイルシステムのロートディレクトリーに到達するまで検索を行う。後者の場合にはnil
をリターンする。
引数name
は述語関数でもよい。この述語は関数により検査される、file
(fileがディレクトリーでない場合でも)から開始されるすべてのディレクトリーにたいして呼び出される。この述語は1つの引数(ファイルかディレクトリー)で呼び出されて、それが検索しているディレクトリーなら非nil
をリターンすること。
この関数は、fileがディレクトリーdir内のファイルかサブディレクトリーならt
をリターンする。またfileとdirが同じディレクトリーの場合もt
をリターンする。この関数は2つのディレクトリーの実名を比較する。dirが既存のディレクトリーの名前でなければリターン値はnil
。
これはどのファイルを報告するか、およびファイル名を報告する方法においてdirectory-files
と似ている。しかしこの関数はファイル名のリストをリターンするかわりに、各ファイルごとにリスト(filename
.
attributes)
をリターンする。ここでattributesは、そのファイルにたいしてfile-attributes
がリターンする値。オプション引数id-formatは、file-attributes
の対応する引数と同じ意味をもつ(Definition of file-attributesを参照)。
この正規表現は‘.’と‘..’を除いたすべてのファイル名にマッチする。より正確にはこれら2つを除いたすべての空文字列以外の部分にマッチする。これはdirectory-files
およびdirectory-files-and-attributes
のmatch-regexp引数として有用。
(directory-files "/foo" nil directory-files-no-dot-files-regexp)
ディレクトリー‘/foo’が空ならnil
をリターンする。
この関数はワイルドカードパターンpatternを展開して、それにマッチするファイル名のリストをリターンする。
patternはデフォルトでは‘"/tmp/*.png"’や‘"/*/*/foo.png"’のような“glob”あるいはワイルドカード文字列だが、オプションのregexpパラメーターが非nil
なら正規表現でもよい。いずれの場合でもマッチが親ディレクトリーとサブディレクトリーにまたがらないように、サブディレクトリーごとに適用される。
絶対ファイル名としてpatternが記述されると値も絶対ファイル名になる。
patternが相対ファイル名で記述されていれば、それはカレントデフォルトディレクトリーにたいして相対的に解釈される。通常はリターンされるファイル名もカレントデフォルトディレクトリーにたいする相対ファイル名になる。しかしfullが非nil
なら絶対ファイル名がリターンされる。
この関数はls
のswitchesに対応するフォーマットで、(カレントバッファー内に)ディレクトリーfileのディレクトリーリストを挿入する。これは挿入したテキストの後にポイントを残す。switchesにはオプション文字列、または個別のオプションを表す文字列リストを指定できる。
引数fileにはディレクトリー、またはワイルドカード文字を含むファイル名を指定できる。wildcardが非nil
ならfileはワイルドカードを伴うファイル指定として扱われることを意味する。
full-directory-pが非nil
なら、ディレクトリーリストにたいしてディレクトリーの完全なコンテンツ表示を要求することを意味する。fileがディレクトリーでスイッチに‘-d’が含まれないときには、t
を指定すること(ls
へのオプション‘-d’は、ディレクトリーのコンテンツではなくファイルとしてディレクトリーを表示するよう指定する)。
ほとんどのシステムでは、この関数は変数insert-directory-program
の名前のディレクトリーリスト用プログラムを実行することにより機能する。wildcardが非nil
なら、ワイルドカード展開するためにshell-file-name
で指定されるシェルの実行も行う。
MS-DOSとMS-Windowsシステムは標準的なUnixプログラムls
を欠くので、この関数はLispコードでls
をエミュレートする。
技術的な詳細としてはswitchesにロングオプション‘--dired’が含まれる際に、insert-directory
はdiredのためにこれを特別に扱う。しかし他のオプションと同様、通常は等価なショートオプション‘-D’が単にinsert-directory-program
に渡されるだけである。
この変数の値は関数insert-directory
用にディレクトリーリストを生成するプログラムである。この値はLispコードでこのリストを生成するシステムでは無視される。