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)。
バッククォートはリーダーの形のままです。