本節では、ファイル名の補完向けの低レベルのサブルーティンについて述べます。 他の補完関数については、Completionを参照してください。
この関数は、ディレクトリdirectoryにおいて partial-filenameで始まる名前のファイルに対する すべての補完候補から成るリストを返す。 候補の順番はディレクトリ内でのファイルの順番であり、 それは予測できず有用な情報はなにもない。
引数partial-filenameは、ディレクトリ部分やスラッシュを いっさい含まないファイル名であること。 directoryが絶対名でないと、 カレントバッファのデフォルトディレクトリをdirectoryのまえに補う。
つぎの例で、カレントデフォルトディレクトリは~rms/lewisであり、 ‘f’で始まる名前のファイルは、 foo、file~、file.c、file.c.~1~、 file.c.~2~の5つであると仮定する。
(file-name-all-completions "f" "") ⇒ ("foo" "file~" "file.c.~2~" "file.c.~1~" "file.c") (file-name-all-completions "fo" "") ⇒ ("foo")
この関数は、ディレクトリdirectoryにおいてファイル名filenameを 補完する。 ディレクトリdirectoryにおいてfilenameで始まる すべてのファイル名に共通な最長の文字列を返す。
filenameで始まるものがたった1つであり完全に一致すると、 この関数は
t
を返す。 ディレクトリdirectoryにfilenameで始まる名前がないとnil
を返す。つぎの例で、カレントデフォルトディレクトリには ‘f’で始まる名前のファイルは、 foo、file~、file.c、file.c.~1~、 file.c.~2~の5つであると仮定する。
(file-name-completion "fi" "") ⇒ "file" (file-name-completion "file.c.~1" "") ⇒ "file.c.~1~" (file-name-completion "file.c.~1~" "") ⇒ t (file-name-completion "file.c.~3" "") ⇒ nil