require

(require module-name [pathname])

モジュールがまだ provide で登録されていなければそのファイルを読み込み、モジュール名をシンボルとして返します。module-name は指示子 (designator) で、キーワード (:util)、シンボル ('util)、文字列 ("util") のいずれかです。明示的な pathname がない場合、ファイル <name>.lisp は load とまったく同じルールで require を書いたファイルからの相対で解決されます。第 2 引数を明示すればそのマッピングを上書きできます。require されるファイルは自身で (provide <name>) を呼ぶことが期待されます (慣習的には先頭のフォームとして) — それがモジュールを登録するため、同じ名前の 2 回目の require はロードせずに消費されます。これにより require はダイヤモンド依存 (a.lisp と b.lisp の両方が utils.lisp を require する場合に 1 回だけロードされる) のための道具になります。load ではファイルが 2 回評価されてしまいます。

インタプリタでは require は通常のランタイム関数です。コンパイルパス (JVM/WASM) では、リテラルなトップレベルの (require ...) がコンパイル時に展開されます: モジュールファイルはコンパイル時 load インクルードと同様にプログラムへ継ぎ足され、コンパイラはその定義をネイティブに認識します。load と異なり、他のフォームの内側にネストした require や計算された引数を持つ require はコンパイルエラーです — コンパイル済みランタイムリーダーへ先送りすることはできません。Common Lisp の *modules* 変数は利用できません。

;; util.lisp
(provide :util)
(defun u-sq (x) (* x x))

;; main.lisp
(require :util)
(require :util)   ; already provided: no second load
(print (u-sq 7))  ; prints 49

最初の require が util.lisp を読み込み、その中の provide がモジュールを登録します。2 回目は no-op で util を返します。