Next: Programmed Completion, Previous: Reading File Names, Up: Completion [Contents][Index]
補完のデフォルト動作を変更するために使用される変数がいくつかあります。
この変数の値は補完を行うために使用される補完スタイル(シンボル)である。補完スタイル(completion
style)とは、補完を生成するためのルールセットのこと。このリストにあるシンボルはそれぞれ、completion-styles-alist
内に対応するエントリーをもたなければならない。
この変数には補完スタイルのリストが格納される。リスト内の各要素は以下の形式をもつ
(style try-completion all-completions doc)
ここでstyleは補完スタイルの名前(シンボル)であり、そのスタイルを参照するために変数completion-styles
内で使用されるかもしれない。try-completionは補完を行なう関数で、all-completions補完をリストする関数、docは補完スタイルを説明する文字列である。
関数try-completionとall-completionsはstring、collection、predicate、pointの4つの引数をとる。引数string、collection、predicateの意味はtry-completion
(Basic Completionを参照)のときと同様。引数pointはstring内のポイント位置。各関数は自身の処理を行ったら非nil
、行わなかった場合(たとえば補完スタイルに一致するようにstringを行う方法がない場合)はnil
をリターンする。
ユーザーがminibuffer-complete
(Completion Commandsを参照)のような補完コマンドを呼び出すと、Emacsはcompletion-styles
に最初にリストされたスタイルを探して、そのスタイルのtry-completion関数を呼び出す。この関数がnil
をリターンしたら、Emacsは次にリストされた補完スタイルに移動してそのスタイルのtry-completion関数を呼び出すといったように、try-completion関数の1つが補完の処理に成功して非nil
値をリターンするまで順次これを行なう。同様の手順はall-completions関数を通じて補完のリストにも行われる。
利用できる補完スタイルについてはCompletion Styles in The GNU Emacs Manualを参照のこと。
この変数は特別な補完スタイルと、特定の種類のテキスト補完時に使用するその他の補完動作を指定する。この変数の値は(category
.
alist)
という形式の要素をもつようなalistである。categoryは何が補完されるかを記述するシンボルで、現在のところカテゴリーにbuffer
、file
、unicode-name
が定義されているが、これに特化した補完関数(Programmed Completionを参照)を通じて他のカテゴリーを定義できる。alistはそのカテゴリーにたいして補完がどのように振る舞うべきかを記述する連想リスト。alistのキーとして以下がサポートされる:
styles
値は補完スタイル(シンボル)のリスト。
cycle
値はそのカテゴリーにたいするcompletion-cycle-threshold
(Completion Options in The GNU Emacs Manualを参照)の値。
将来、さらにalistエントリーが定義されるかもしれない。
この変数はカレント補完コマンドの特別なプロパティの指定に使用される。この変数は補完に特化したコマンドによりletバインドされることを意図している。値はプロパティ/値ペアーのリスト。以下のプロパティがサポートされる:
:annotation-function
値は補完バッファー内に注釈(annotation)を加える関数。この関数は引数completionを1つ受け取りnil
、または補完の隣に表示する文字列をリターンしなければならない。
:exit-function
値は補完を行った後に実行する関数。この関数は2つの引数stringとstatusを受け取る。stringは補完されたフィールドのテキストで、statusは行われた操作の種類を示す。操作の種類はテキストの補完が完了したならfinished
、それ以上補完できないが補完が完了していなければsole
、有効な補完だがさらに補完できるときはexact
となる。