Next: Calling Functions, Previous: Function Names, Up: Functions [Contents][Index]
わたしたちは通常は関数を最初に作成したときに名前を与えます。これは関数の定義(defining a
function)と呼ばれており、通常はdefun
マクロにより行われます。このセクションでは関数を定義する別の方法も説明します。
defun
は新たなLisp関数を定義する通常の方法である。これは引数リストargs、およびbodyにより与えられるbodyフォームとともに、シンボルnameを関数として定義する(Argument Listを参照)。nameとargsをクォートする必要はない。
docが与えられたら、それはその関数のドキュメント文字列を指定する文字列であること(Function Documentationを参照)。declareが与えられたら、それは関数のメタデータを指定するdeclare
フォームであること(Declare Formを参照)。interactiveが与えられたら、それは関数が対話的に呼び出される方法を指定するinteractive
フォームであるこ(Interactive Callを参照)。
defun
のリターン値は定義されていません。
以下にいくつか例を示す:
(defun foo () 5) (foo) ⇒ 5
(defun bar (a &optional b &rest c) (list a b c)) (bar 1 2 3 4 5) ⇒ (1 2 (3 4 5))
(bar 1) ⇒ (1 nil nil)
(bar) error→ Wrong number of arguments.
(defun capitalize-backwards () "Upcase the last letter of the word at point." (interactive) (backward-word 1) (forward-word 1) (backward-char 1) (capitalize-word 1))
意図せず既存の関数を再定義しないように注意されたい。defun
はcar
のようなプリミティブ関数でさえ、問い合わせせずに躊躇なく再定義する。Emacsがこれを妨げることはない。なぜなら関数の再定義は故意に行われることがあり、そのような意図した再定義を、意図しない再定義と見分ける方法はがないからである。
この関数は定義definition(任意の有効なLisp関数)とともに、シンボルnameを関数として定義する。この関数のリターン値は未定義。
docが非nil
なら、それは関数nameのドキュメントとなる。それ以外ならdefinitionにより提供されるドキュメントが使用される。
内部的にはdefalias
は、通常は定義のセットにfset
を使用する。しかしnameがdefalias-fset-function
プロパティーをもつなら、fset
を呼び出すかわりにそれに割り当てられた値を使用する。
defalias
を使う正しい場所は、特定の関数名が正に定義される場所 —
特にソースファイルがロードされるとき明示的にその名前が出現する場所である。これはdefalias
がdefun
と同じように、どれが関数を定義するファイルなのか記録するからである(Unloadingを参照)。
それとは対象的に他の目的のために関数を操作するプログラムでは、そのような記録を保持しないfset
を使用するほうがよいだろう。Function Cellsを参照のこと。
defun
やdefalias
で新たなプリミティブ関数を作成することはできませんが、任意の関数定義を変更するのに使用することができ、通常の定義がプリミティブであるcar
やx-popup-menu
のような関数でさえ変更することができます。しかしこれは危険なことです。たとえばLispの完全性を損なうことなく、car
を再定義するのはほとんど不可能だからです。それほど有名ではないx-popup-menu
のような関数の再定義では、危険は減少しますが、それでも期待したとおりに機能しないかもしれません。Cコードにそのプリミティブの呼び出しがあれば、それは直接そのプリミティブのC定義を呼び出すので、シンボル定義を変更してもそれらに影響はありません。
defsubst
も参照してください。これはdefun
のように関数を定義して、それのインライン展開を処理するようLispコンパイラーに指示します。Inline Functionsを参照してください。
関数名を未定義にするにはfmakunbound
を使用します。Function Cellsを参照してください。