macroexpand-1
(macroexpand-1 form)
マクロ呼び出しを 1 回だけ展開し、展開結果をデータとして返します。mangle された
データそのものなので、quote したフォームとの = が成り立ち、表示は oracle と同じ
小文字綴りになります。先頭がマクロでないフォームはそのまま返ります。先頭の名前は oracle と
同じく呼び出しが実行される時点の *ns* で解決します。修飾のない名前はその名前空間自身の
マクロと refer、別名で修飾した名前はその名前空間の別名を通ります。core マクロは、その名前を
名前空間が定義・refer・除外していない限り、修飾のない名前で解決します。関数値としても使えます。
core マクロは oracle と同じフォームに展開します。let は分配束縛を展開した束縛の上の
let* に、fn は fn* に、case はハッシュで引くマップの上の case* に、doseq と
for はチャンク単位の走査に、defrecord・deftype・reify は deftype*・reify* に(レコード自身の
マップのメソッドが本体のものより前に並び、マクロが書き換えて lower できます)なり、
仕様との差異 に挙げたマクロも同様です。
それ以外の core マクロ(lazy-seq、defmacro など)はフォームそのものを返します。マクロ
呼び出しはすべてマクロの関数を通ります。この関数はマクロの var が持ち、oracle と同じく
呼び出し・環境・呼び出しの引数をとります。(#'when '(when a b) nil 'a 'b) は
(if a (do b)) を返します。
環境は、oracle と同じく見えているローカルです。プログラムの実行中にはローカルがないので、
マクロの &env は nil です。マクロ本体の中では呼び出し位置のローカルなので、本体が展開する
マクロはそれを &env として受け取ります(riddley は、走査するコードのローカルを
これに加えます)。先頭がそのどれかのローカルを指すフォームは、そのまま返ります。