(rontolisp) docs
← マクロ

defmacro

(defmacro name doc? attr? [params] body...) / (defmacro name doc? attr? ([params] body...)+)

コンパイル時マクロを定義します。各呼び出し位置は lower 中に展開され、バックエンドが 動く前に済むため、すべてのバックエンドは展開後のコードを実行します。パラメータには 呼び出し側の引数フォームが未評価で束縛されます(& 以降はリストとして残り、 destructuring も可能です。複数のアリティは引数の個数で切り替わります(defn と同様)。 docstring と attr map は読み飛ばされます。本体の暗黙の &form は呼び出しそのもの、 &env は呼び出し位置のローカルを各シンボルからそれ自身へ写すマップで、ローカルがなければ nil です(oracle の値はコンパイラの LocalBinding)。そのため .cljc ライブラリの (contains? &env :locals) は Clojure 側の分岐をとります。実行時の macroexpand は oracle と同じく &form を束縛し、&env は nil のままです。本体が呼ぶ macroexpand-1 は、呼び出し位置のローカルを &env として渡します。 どちらもパラメータ名には使えません。

定義は nil を返し、同じ expander を実行時テーブルにも登録するため、 macroexpand-1 は実行時にも同じ関数で展開します。マクロ本体が見えるのは核の built-in と clojure.lisp ライブラリであり、プログラム自身の定義は見えません。定義より 上での呼び出しはエラーとなり、マクロに関数値は存在しません。

核の名前(inc のような関数も with-out-str のようなフォームも)の defmacro は、 定義以降でその名前を覆い隠します。定義より上の呼び出し位置は oracle のフォーム単位の コンパイルと同じく核の意味を保ち、clojure.core/name はプログラムが何を定義していても 核の var を指します。リーダーが綴る先頭(deref、with-meta、ns、in-ns)はマクロの 名前にできません。special form(def、if、& など)はマクロの名前にでき、限定名でだけ 呼べます(spec.alpha の clojure.spec.alpha/def を s/def と書くなど)。素の先頭は special form のままです。syntax-quote の先頭 (syntax-quote、unquote、unquote-splicing。oracle のリーダーはこれらを綴りません)は マクロの名前にでき、限定名で呼びます(tools.reader の clojure.tools.reader/syntax-quote)。 バッククォートはリーダーの形のままです。