(rontolisp) docs
← マルチメソッドと階層

print-method

(defmethod print-method Type [x writer] body...) / (print-method x writer)

clojure.core/print-method はプリンタのマルチメソッドです。プログラムが自分の record や deftype に定義したメソッドは、pr・prn・print・println・pr-str・prn-str・print-str・ println-str と REPL がその型の値を書く方法になり、コレクションの中や、コレクションの str の一部でも使われます。writer は書き込み先のストリームです。文字列を .write するか、 binding [*out* writer] して印字します。print の下でメソッド内の pr は print と同じく 書きます(oracle の print と同じく *print-readably* が nil になります)。関数として呼ぶと print-method は x をその型のメソッドで書き、メソッドがなければ pr と同じく書きます。 remove-method は既定の書き方に戻し、get-method はメソッドを返します(なければ print-method 自身)。

:type キーワードのメソッドは、そのキーワードをメタデータに持つ((:type (meta x))) すべての値を書きます。record や deftype のタグのメソッドより先に使われます。oracle は print-method を (:type (meta x)) で先にディスパッチするからです。

ホストクラス(java.util.Date)のメソッドは、インタプリタと JVM でそのクラスかサブクラスの ホストオブジェクトを書きます。tools.reader の #inst リーダはホストの Date を返し、それを 自身のメソッドで印字します。

defmethod が計算するディスパッチ値(関数の引数や var)は defmethod の実行時に読みます。 record のクラスを受け取る関数(rewrite-clj の make-printable!)や :type キーワードを 受け取る関数は、そのときその値の下にメソッドを格納します。

プロトコルのインタフェース(ドット付きの名前、user.Shape)のメソッドは、本体でそのプロトコルを 実装するすべての record・deftype・reify を書きます(拡張では実装になりません)。record の クラスはプリンタ自身の clojure.lang.IRecord・java.util.Map・clojure.lang.IPersistentMap のメソッドにも一致するため、oracle と同じく、インタフェースのメソッドが record を書くのは prefer-method でその3つすべてより優先したときだけです。print-method の名前の呼び出しでも 値経由でも優先できます(schema の (doseq [m [print-method ...]] (prefer-method m ...)))。 一致する2つのメソッドのどちらも優先されていなければ、oracle の IllegalArgumentException (Multiple methods in multimethod 'print-method' ...)です。

逸脱: メソッドを持てるのはプログラム自身の record・deftype・プロトコルのインタフェース・ :type キーワードと、インスタントか UUID 以外のコアの値が属さないホストクラスです。ここで 作ったインスタントや UUID は自分の印字(#inst/#uuid。oracle やライブラリのメソッドが書く 内容)のままで、自身のクラスのメソッドがないホストの Timestamp・Calendar・UUID は ホストオブジェクトとして印字します。Object、コアの値が属するクラス(String、 java.util.Map)、clojure.lang のクラス、nil のメソッドは名前で拒否し(計算した値と ホストクラスは defmethod の実行時に UnsupportedOperationException として拒否します)、 print-method の methods も同様です。値そのものの str は、oracle がその toString を 返すところで、メソッドが書く内容を返します。deftype と reify はインタフェースのメソッドの ほかにプリンタ自身のメソッドに一致しないため、コレクションのインタフェースも実装するものは、 oracle が優先を求めるところでインタフェースのメソッドを使います。優先が行の一部しか決めない 場合、oracle の答えはメソッド表のハッシュ順で決まりますが、ここでは行を固定の順(IRecord、 java.util.Map、IPersistentMap、次にメソッドを最初に格納した順のインタフェース)で 調べます。