9.7 gauche.hook - フック

Module: gauche.hook

フックオブジェクトを提供します。これは、特定のタイミングで 呼び出されるクロージャのリストを管理するものです。

フックのAPIはGuileのそれと上方互換で、下記のように拡張されています。

• Gaucheのオブジェクトシステムをベースにしています。 ほとんどのAPIはメソッドなので、フックの機能を拡張することが できます。
• フックオブジェクトはそれ自身適用可能です。run-hookを使う必要は ありません。
• フックから手続きを削除するメソッドは、SRFI-1やその他との一貫性の ためにdelete-hook!と呼ばれます。 Guileとの互換性のために、remove-hook!がdelete-hook!の エイリアスとして定義されています。

Class: <hook>

フックのクラスで、一度に呼び出される手続きのリストを保持しています。

<hook>クラスにはobject-applyメソッドが定義されているので、 あたかもそれが手続きであるかのようにフックオブジェクトを“適用”できます。 フックオブジェクトを適用すると、登録されている全ての手続きが呼び出されます。

Function: make-hook &optional (arity 0)

与えられたアリティ(正の整数でなければなりません)とともに新しい フックオブジェクトを作成します。

Function: hook? obj

objがフックオブジェクトであれば、真を返します。

Function: hook-empty? hook

hookの手続きリストが空なら、真を返します。

Method: add-hook! (hook <hook>) proc &optional (append? #f)

手続きprocをhookに追加します。 append?が与えられ真であれば、procはリストの最後に 追加されます。そうでなければ、procはリストの最初に追加 されます。 procは、make-hook時に与えられたアリティとともに 呼ばれなければなりません。

Method: delete-hook! (hook <hook>) proc

Method: remove-hook! (hook <hook>) proc

hookの手続きリストからprocを削除します。 Guileとの互換性のためだけに、remove-hook!がdelete-hook!の エイリアスとなっています。

Method: reset-hook! (hook <hook>)

hookの手続きリストを空にします。

Method: hook->list (hook <hook>)

hookの手続きリストのコピーを返します。

Method: run-hook (hook <hook>) arg …

hookの手続きを、arg …を引数として順番に呼び出します。 引数の数は、make-hook時に与えられたアリティにマッチしなければ なりません。

This document was generated by Shiro Kawai on November, 22 2009 using texi2html 1.78.