(rontolisp) docs
← プロトコル、レコード、型

reify

(reify Protocol (method [target & args] body...) ...)

評価ごとに新しい値を答えます。使い切りのマップにメソッドを添えたものであり、 proxy ではありません(proxy は java: サーフェスのまま)。メソッドの行は フォームに属し、オラクルの reify フォームごとに 1 つのクラスと同じく、各プロトコルの 表に一度だけ格納されます。各インスタンスは自分の評価が作ったメソッドを持ち、 それらはその評価のローカルを閉じ込めます。2つのインスタンスが = になることは 決してありません(オラクル同様)。それ以外の = は同一性です。メソッド群は extend-type 同様プロトコル名の下に 置きます。メソッド名を別のパラメータベクターで書き直すと、そのメソッドの別のアリティを 実装します。

clojure.core.protocols/CollReduce の reify は、reduce・into・transduce がその coll-reduce を通して畳み込むコレクションになります(clojure.core.reducers のレデューサーはこの形で作られています)。

ホストのインタフェース

本体は、コア関数が参照する clojure.lang のインタフェースも実装でき、Object の toString・equals・hashCode も上書きできます。インタフェースはパッケージ付きで綴るか import します(オラクル同様、clojure.lang は既定の import に含まれません)。メソッドは名前と パラメータ数で本体のすべてのグループと照合されるため、toString をプロトコルの下に書くことも できます。

インタフェース読む関数
IReduceInit, IReducereduce(初期値なしは IReduce を通す)、into、transduce、run!、mapv、filterv、vec、set、group-by、frequencies
IKVReducereduce-kv、update-vals、update-keys
Seqableseq と seq を辿るすべての関数(first、map、filter、doseq、for など)、seqable?
Countedcount、empty?、counted?
Indexed(Counted を含む)nth、ベクタの分配束縛、indexed?
ILookupget、get-in、キーワードやシンボルの呼び出し、マップの分配束縛
IFn(Callable と Runnable を含む)呼び出し、関数引数(map、filter など)、apply(applyTo を通す)、ifn?
IDerefderef、@
IBlockingDerefタイムアウトとタイムアウト値を取る deref
IAtom、IAtom2アトムでない値の swap!、reset!、compare-and-set!、swap-vals!、reset-vals!
IRef、IReferenceadd-watch、remove-watch、set-validator!、get-validator、alter-meta!、reset-meta!
IFn$OOL などのプリミティブ IFn インターフェース.invokePrim(値の呼び出しは IFn の invoke を通ります)、instance?
IMeta, IObjmeta、with-meta、vary-meta(deftype のみ。reify は自身でメタデータを持ちます)
java.lang.CharSequencecount(length)、nth、seq と seq を辿るすべての関数(charAt)、seqable?。re-matcher と re-find は照合に要るところまでその文字を(charAt で)読み、re-seq・re-matches・clojure.string・文字列の .contains と .replace は全文字を並べた文字列を読みます
Objectstr と印字(toString)、=(equals)、.hashCode と IHashEq がない場合の hash(hashCode)

プログラムの definterface はホストクラスなしのインタフェースを定義します。名前は バイナリ名(my-app.core.Name、deftype のクラス同様)に束縛され、それを挙げた本体は その名前の下に型の行にメソッドを格納します。形は上の行と同じです。オラクルのクラス同様、 instance? はその名前を調べ、.method 呼び出しは行のメソッドにディスパッチします。 シグネチャは1つのパラメータベクターを伴うメソッド名((m [x y]))で、ベクターなし ((m))は引数なしメソッドです。重複したシグネチャは、重複をシグネチャ付きで名指して 拒否されます。それ以外の形も拒否されます。そのインタフェースへのプロトコルの拡張は、 プロトコルでないものとして拒否されます。

インタフェースへの instance? と、そのメソッドのインスタンス呼び出し((.count x))も型に 届きます。そのインタフェースへ拡張したプロトコルも同様です。本体が書かなかったメソッドを呼ぶと オラクルの AbstractMethodError になり(java.util の default メソッドはインタフェース側の実装の ままで、呼ぶと名前を挙げて拒否されます)。IType、IRecord、IKeywordLookup は instance? が読む目印です(IRecord を実装する型は record? です)。それ以外の clojure.lang のインタフェース (IChunkedSeq など)は名前を挙げて拒否されます。それ以外の public なホストのインタフェース (java.io.Closeable、java.util.concurrent.ThreadFactory、java.util.concurrent.locks.Lock など)は、definterface と同じく型の行にバイナリ名でメソッドを格納します。instance? は それ(とそのスーパーインタフェース)を判定し、コア関数が答えない .method 呼び出しは行の メソッドを呼び、with-open は Closeable を閉じます。本体が書かなかった default メソッドを Clojure から呼ぶと拒否されます(オラクルはインタフェース側の実装を実行します)。本体が実装した Java のインタフェース (Runnable、Comparable、java.util.Comparator、Iterable、java.util のコレクション、上記のホストのインタフェース)と上書きした Object の メソッドは、Java から見た値にも及びます。値は Java のメンバへ、それらを実装したオブジェクト として渡ります(Java interop)。仕様との差異:toString を上書きした値は #object[user$reify "text"] と印字され、オラクルのクラス番号と同一性ハッシュを持ちません。 CharSequence に対する re-matcher と re-find は、読む範囲を先頭の 16、32、64 ... 文字と 広げていくので、オラクルのマッチャが止まる位置より先まで charAt を呼ぶことがあります。ほかの 正規表現の関数と clojure.string は CharSequence を呼び出しごとに length と charAt で 全体を一度読みます。オラクルのマッチャは照合に要るところまでしか読まず、clojure.string の 関数の多くは toString を呼びます。

コレクションのインタフェース

本体はコレクションも実装できます。コア関数は、オラクルが問い合わせる順にそのメソッドを通して 読みます。インタフェースのスーパーインタフェースも実装に含まれます(IPersistentMap は Associative、Iterable、Counted でもあります)。

インタフェース読む関数
IPersistentCollectionconj、into、merge(cons)、empty、両辺の =(equiv)、Counted でない場合の count(seq を最後まで辿る)、coll?
Associativeassoc、update、assoc-in(assoc)、contains?(containsKey)、find、select-keys(entryAt)、associative?
IPersistentMap, MapEquivalencedissoc(without)、keys、vals、reduce-kv、map?、マップとしての印字。マップの = が java.util.Map として読むのは MapEquivalence を持つ場合だけです
IPersistentSetdisj(disjoin)、contains?、get とキーワードの呼び出し(contains、get)、set?、集合としての印字
IPersistentStackpeek、pop
IPersistentVectorvector?、ベクタとしての印字、ベクタの =(count、nth)、subvec
ISeqseq がこれを返すと first と next で辿ります。seq?、seq としての印字
Sequential, IPersistentListsequential?、list?。シーケンシャルな値の = と nth は seq を辿ります
Reversiblerseq、reversible?
IPendingrealized?
Sortedsubseq、rsubseq(seqFrom、seq、comparator、entryKey)、sorted?
java.lang.Comparablecompare、sort、ソート済みコレクションの既定の順序
java.util.Comparatorsort、sort-by、sorted-map-by、sorted-set-by(compare)
java.lang.IterableSeqable でない場合の seq、reduce、into、vec(iterator)、seqable?
java.util.Iteratoriterator-seq、Iterable の seq と畳み込み
java.util.Collection, List, Set, RandomAccesscount(size)、nth(RandomAccess なリストの get)、contains?(Set の contains)、=、pr でのリスト・ベクタ・集合としての印字
java.util.Mapget、contains?、find、count、seq(entrySet)、=、pr でのマップとしての印字
IHashEqhash(hasheq)、要素にしたときのコレクションのハッシュ関数
java.io.Serializable, IEditableCollection、トランジェントinstance? とインスタンス呼び出し。transient は asTransient を、persistent! と ! 付きの操作はトランジェントのインターフェースのメソッドを呼びます

コアのコレクションへの (.iterator coll)、clojure.lang.SeqIterator、clojure.lang.RT/iter は seq を辿るイテレータを返し、clojure.lang.MapEntry はここでのマップエントリである [k v] ベクタを作ります。仕様との差異:ISeq 型への first・next・rest はその seq を通して 読みます(オラクルは first・next・more を直接呼びます)。そのため next と rest は その seq の残りを返します。チャンク化した seq がないため、関数がメソッドを呼ぶ回数はオラクルと 異なることがあります。こうした値の str はオラクルの Class@hash ではなく中身を綴り、 java.util の型は print でも中身を印字します。

マップのキーと集合の要素

型自身がハッシュ(IHashEq の hasheq、Object の hashCode)と等価性 (IPersistentCollection の equiv、Object の equals、またはコアのコレクションが読む マップ・集合・シーケンシャルのインタフェース)を定める値は、オラクルのハッシュマップと同じく、 マップのキーや集合の要素として = で照合されます。マップ・集合・シーケンシャルの型の値は、 それと = なコアのコレクションで検索でき、コアのコレクションを格納したマップや集合もその値で 検索できます(集合の要素にした data.priority-map など)。それ以外の型の値は、その型の等価性が = と判定する値で検索できます。コアのキーと同じく、先に格納したキーが残ります。型自身が ハッシュを定めない値は同一性で照合されます。オラクルのハッシュマップも、そうした値を同一性に 基づくハッシュで振り分けるためです。

仕様との差異:ここではどのマップもオラクルのハッシュマップと同じ方法でキーを照合します。 オラクルの配列マップ(8 エントリまで)はハッシュを使わずにキーを比べるので、型自身がハッシュを 定めない値も = な値で検索でき、java.util.Collection でも Map でもない検索キーは equals だけで比べます。マップ・集合・シーケンシャルの型の値は hasheq ではなく中身で振り分けられる ため、hasheq が = と食い違う型の値も検索できます。それ以外の型の値は型自身のハッシュで 振り分けられるため、その equiv が等しいと答えるコアのコレクションでは検索できません。