(rontolisp) docs
← 関数

asdf パッケージの関数

asdf パッケージは、.asd 定義から複数ファイルのシステムをロードするための、ASDF の 限定的な API 互換サブセットです。Common Lisp の一部ではありません。シンボルは asdf: 修飾子付きで参照します。各名前は個別のページにリンクしています。プロジェクトの 全体像と探索パスの詳細は システムガイドを参照してください。

関数例結果
asdf:defsystem(asdf:defsystem :my-lib :components ((:file "main")))システムを定義する (名前・:depends-on・:serial・:components)。後続の load-system 用
asdf:load-system(asdf:load-system :my-lib)システムをロードする: まず依存システム、次にコンポーネントファイルを順に (コンパイルパスではリテラルかつトップレベルのフォーム)
asdf:test-system(asdf:test-system "my-app")システムをロードし、:in-order-to の test-op 連鎖をたどって、記録された :perform (test-op ...) 本体を実行する — .asd の標準テストエントリポイント
asdf:operate(asdf:operate 'asdf:load-op :my-lib)システムに operation を perform する: load-op は load-system、test-op は test-system と同じ。それ以外の operation はエラーを通知する
asdf:perform(defmethod asdf:perform :around ((o asdf:load-op) (c asdf:cl-source-file)) ...)総称関数: システムのロードを構成する各動作 (各ファイルとシステムへの prepare-op・compile-op・load-op)。ライブラリのメソッドはコンポーネントのロードごとにその周りで実行される
asdf:oos(asdf:oos 'asdf:load-op :my-lib)operate の旧名。load-systems、load-systems*、require-system もロードの別の書き方で、:build-operation のないシステムの make もそうです。program-op のシステムの make は実行ファイルをビルドします(ASDF システムから実行ファイルをビルドする)
asdf:load-asd(asdf:load-asd "vendor/old/my-lib.asd")1 つの .asd ファイルの定義をロードする
asdf:clear-system(asdf:clear-system :my-lib)システムを忘れる。次の find-system は探索し直す
asdf:map-systems(asdf:map-systems #'print)登録済みの各システムを引数に関数を呼ぶ。already-loaded-systems、component-loaded-p、registered-system で状態を問い合わせる
asdf:find-component(asdf:find-component :my-lib "main")コンポーネントを名前、または木をたどる名前のリストで探す。なければ nil。module-components は component-children と同じ
asdf:system-description(asdf:system-description (asdf:find-system :my-lib))defsystem の宣言を読む。他の system- リーダー、component-property、system-source-file も同様
asdf:*central-registry*(push "vendor/my-lib/" asdf:*central-registry*)探索パスより先に NAME.asd を探すディレクトリ
asdf:initialize-source-registry(asdf:initialize-source-registry '(:source-registry (:tree :here) :inherit-configuration))探索先を設定する (:directory、:tree、:here、継承する設定)。clear-source-registry で取り消す
asdf:*system-definition-search-functions*(push 'vendor-search asdf:*system-definition-search-functions*)探索で順に呼ぶ関数。名前を受け取り、パス名かシステムを返す
asdf:find-system(asdf:find-system :my-lib nil)システムのメタオブジェクト。名前ごとにメモ化された本物の asdf:system CLOS インスタンス (呼び出し間で eq)。error-p が nil なら未知の名前に nil
asdf:registered-systems(asdf:registered-systems)登録済みのすべてのシステムの小文字化された名前 (登録順)
asdf:system-relative-pathname(asdf:system-relative-pathname :my-lib "data/tlds.dat")システムのソースディレクトリを基準に解決した名前文字列 (コンパイルパスではリテラルへ畳み込まれる)
asdf:component-pathname(asdf:component-pathname (asdf:find-system :my-lib))システムまたはモジュールのディレクトリ (末尾に /)、またはファイルの解決済みパス。メタオブジェクトも名前指示子も受け付ける
asdf:component-name(asdf:component-name (asdf:find-system :my-lib))リーダー: 定義に書かれたコンポーネントの名前 (シンボルは小文字化)
asdf:component-version(asdf:component-version (asdf:find-system :my-lib))リーダー: 宣言された :version 文字列。素の文字列で宣言されていなければ nil (計算された書き方は評価されません)
asdf:component-children(asdf:component-children (asdf:find-system :my-lib))リーダー: システムまたはモジュールの子 (定義順)。asdf:module、asdf:cl-source-file、asdf:static-file などのインスタンス
asdf:component-sideway-dependencies(asdf:component-sideway-dependencies (asdf:find-system :my-lib))リーダー: システムの :depends-on の名前 (package-inferred のサブシステム名を含む)
asdf:component-parent(asdf:component-parent child)リーダー: 親コンポーネント — その子を持つシステムまたはモジュール、システムでは nil
asdf:component-system(asdf:component-system child)コンポーネントが属するシステム (component-parent をたどる)

本物の ASDF 3.3.1 がエクスポートする他の名前も、すべて読み込めてどのバックエンドにも定義があるので、 それを書いたライブラリはロードできます。クラスはクラスとして、総称関数はメソッドを受け付け、変数は nil で、関数の呼び出しはその名前を示す uiop:not-implemented-error を通知します。バンドルと プログラムの operation はクラスで、asdf:operate が名前を示して拒否します。