15.1 プログラムがロードを行う方法

Emacs Lispにはロードのためのインターフェイスがいくつかあります。たとえばautoloadはファイル内で定義された関数にたいしてプレースホルダーとなるオブジェクトを作成します。この関数はオートロードされる関数を呼び出すために、ファイルからその関数の実際の定義の取得を試みます(Autoloadを参照)。requireはファイルがまだロードされていない場合にファイルをロードします(Named Featuresを参照)。これらすべての関数は処理を行うために最終的にloadを呼び出します。

Function: load filename &optional missing-ok nomessage nosuffix must-suffix

この関数はLispコードのファイルを見つけてオープンして、その中のすべてのフォームを評価してそのファイルをクローズする。

ファイルを見つけるために、まずloadはfilename.elcという名前、つまりfilenameに拡張子‘.elc’を足した名前のファイルを探します。このようなファイルが存在したら、それをロードします。その名前のファイルが存在しない場合、loadはfilename.elという名前のファイルを探します。このファイルが存在したら、それをロードします。最後に、もしこれらの名前がどちらも見つからなかった場合、loadは何も付け足さないfilenameという名前のファイルを探して、それが存在したらロードします。(load関数にfilenameを認識する賢さはありません。foo.el.elのような正しくない名前のファイルの場合も、(load "foo.el")の評価によりそれを見つけてしまいます。)

Auto Compressionモードが有効(残念ながらデフォルトでは有効ですが)の場合、loadは他のファイル名を試みる前に圧縮されたバージョンのファイル名を探すので、ファイルを見つけることができません。圧縮されたファイルが存在したら、それを解凍してロードします。loadはファイル名にjka-compr-load-suffixes内の各サフィックスを足して、圧縮されたバージョンを探します。この変数の値は、文字列のリストでなければなりません。標準的な値は(".gz")です。

オプション引数nosuffixが非nilなら、loadはサフィックス‘.elc’と‘.el’のロードを試みない。この場合はロードしたいファイルの正確な名前を指定しなければならない。ただしAuto Compressionモードが有効ならloadは圧縮されたバージョンを探すために、jka-compr-load-suffixesを使用する。正確なファイル名を指定して、nosuffixにtを使用することにより、foo.el.elのような名前のファイルにたいするロードの試みを抑止できる。

オプション引数must-suffixが非nilの場合、loadはロードに使用されるファイルの名前に明示的にディレクトリー名が含まれていなければ、ファイル名が‘.el’か‘.elc’で終わること(あるいは圧縮による拡張子が付加されているかもしれません)を要求します。

オプションload-prefer-newerが非nilの場合、loadはサフィックスを検索するとき、どのファイルであっても(‘.elc’、‘.el’など)、もっとも最近変更されたファイルのバージョンを選択します。

filenameがfooやbaz/foo.barのような相対ファイル名なら、loadは変数load-pathを使用してそのファイルを探す。これはload-path内にリストされた各ディレクトリーにfilenameを追加して、最初に見つかった名前のマッチするファイルをロードする。デフォルトディレクトリーを意味するnilがload-pathで措定されたときだけ、カレントデフォルトディレクトリーを試みる。loadはload-path内の最初のディレクトリーで利用可能な3つのサフィックスすべてを試行してから、2つ目のディレクトリーで3つのサフィックスすべてを試行する、...というようにファイルを探す。Library Searchを参照のこと。

最終的に見つかったファイル、およびEmacsがそのファイルを見つけたディレクトリーが何であれ、Emacsはそのファイル名を変数load-file-nameの値にセットする。

foo.elcがfoo.elより古いと警告されたら、それはfoo.elのリコンパイルを考慮すべきことを意味する。Byte Compilationを参照のこと。

(コンパイルされていない)ソースファイルをロードしたとき、Emacsがファイルをvisitしたときと同じようにloadは文字セットの変換を行う。Coding Systemsを参照のこと。

コンパイルされていないファイルをロードするとき、Emacsはそのファイルに含まれるすべてのマクロ(Macrosを参照)を展開する。わたしたちはこれをeagerマクロ展開(eager macro expansion)と呼んでいる。(関連するコードを実行するまで展開を延期しないで)これを行うことにより、コンパイルされていないコードの実行スピードが明らかに向上する。循環参照によりこのマクロ展開を行うことができないときもある。これの一番簡単な例は、ロードしようとしているファイルが他のファイルで定義されているマクロを参照しているが、そのファイルはロードしようとしているファイルを必要としている場合である。これは一般的には無害である。Emacsは問題の詳細を与えるために警告(‘Eager macro-expansion skipped due to cycle…’)をプリントするが、単にその時点ではマクロを展開せずにそのファイルをロードする。あなたはこの問題が発生しないようにコードをリストラクチャーしたいと思うかもしれない。コンパイル済みファイルではマクロ展開はコンパイル時に行われるので、ロード時のマクロ展開は行われない。Compiling Macrosを参照のこと。

nomessageが非nilでなければ、エコーエリアに‘Loading foo...’や‘Loading foo...done’のようなメッセージがロードの間に表示される。

ファイルをロードする間のハンドルされないエラーはロードを終了させる。autoloadのためのロードの場合、ロードの間に定義された任意の関数定義は元に戻される。

loadがロードするファイルを見つけられいと、通常は(‘Cannot open load file filename’メッセージとともに)エラーfile-errorがシグナルされる。しかしmissing-okが非nilなら、loadは単にnilをリターンする。

式の読み取りにたいしてloadがreadのかわりに使用する関数を指定するために、変数load-read-functionを使用できる。以下を参照されたい。

ファイルが正常にロードされたら、loadはtをリターンする。

Command: load-file filename

このコマンドはファイルfilenameをロードする。filenameが相対ファイル名のなら、それはカレントデフォルトディレクトリーを指定したとみなされる。このコマンドはload-pathを使用せず、サフィックスの追加もしない。しかし(Auto Compressionモードが有効なら)圧縮されたバージョンの検索を行う。ロードするファイル名を正確に指定したければ、このコマンドを使用すること。

Command: load-library library

このコマンドはlibraryという名前のライブラリーをロードする。このコマンドは引数を読み取る方法がインタラクティブであることを除きloadと同じ。Lisp Libraries in The GNU Emacs Manualを参照のこと。

Variable: load-in-progress

この変数はEmacsがファイルをロード中なら非nil、それ以外はnilである。

Variable: load-file-name

このセクションの最初に説明した検索でEmacsがファイルを見つけて、そのファイルをロード中のとき、この変数の値はそのファイルの名前である。

Variable: load-read-function

この変数はloadとeval-regionが式を読み取るために、readのかわりに使用する関数を指定する。指定する関数はreadと同様、引数が1つの関数であること。

通常、この変数の値はnilで、これはそれらの関数がreadを使用すべきことを意味します。

この変数を使用するかわりに別の新たな方法を使用するほうが明確である。それはeval-regionのread-function引数にその関数を渡す方法である。Evalを参照のこと。

Emacsのビルドでloadがどのように使用されているかについての情報は、Building Emacsを参照のこと。