E.8 動的にロードされるモジュールの記述

このセクションでがEmacsのモジュールAPI、およびEmacs用の拡張モジュール記述の一部としてそれらを使用する方法について説明します。モジュールAPIはCプログラム言語で定義されているので、このセクション内の記述と例はモジュールがCで記述されていると仮定します。別のプログラム言語ではCコード呼び出しのための適切なバインディングやインターフェースと機能の使用が必要になるでしょう。EmacsのCコードにはC99以降のコンパイラー(C Dialectを参照)が必要であり、このセクションもこの標準にしたがいます。

モジュールの記述とEmacsへの統合には以下のタスクが含まれます:

• モジュール用の初期化コードの記述。
• 1つ以上のモジュール関数の記述。
• Emacsとモジュール間での値とオブジェクトのやり取り。
• エラーコンディションと非ローカル脱出のハンドリング。

以下のサクセクションこれらのタスクとAPI自体の詳細を説明します。

モジュールを一度記述したら共有ライブラリーを生成するために、背景のプラットドームの慣習に応じてモジュールをコンパイルします。その後でload-path (Library Searchを参照)に言及されたディレクトリー内(Emacsが共有ライブラリーを探す場所)にそれを配置します。

EmacsダイナミックモジュールAPIにたいしてモジュールの適合性を検証したければ--module-assertionsオプションでEmacsを呼び出します。Initial Options in The GNU Emacs Manualを参照してください。