(rontolisp) docs

構文

リーダは Clojure のもので、大文字小文字を区別します:Foo と foo は別の変数です。 すべての識別子は低下の際に c% 接頭辞の後ろでマングルされるので、Clojure の名前が核フォーム やビルトインと衝突することはありません。クオートされたシンボルはマングルから戻るので、 'e2e-foo は e2e-foo と印字されます。

ディスパッチとコメント構文

, は Clojure と同様に空白です。; と #! は行コメントです(#! は shebang 行に使えます)。 #_ は次のフォームのスキップです(閉じ括弧の直前やファイル末尾の #_ も読み飛ばすので、 [1 #_ 2] は [1] です)。#'x は (var x) と読まれ、定義の var になります (var 参照)。構文クォート(`、~、~@)は セマンティクスにあります。正規表現リテラル(#"...")はパターン値に読まれます(正規表現 参照)。メタデータ(^、旧表記の #^)も 読まれます。名前やローカルについたものは解析して捨てられ、ベクター・マップ・セットの リテラルについたものは with-meta と同様に付き、クォートしたシンボルやコレクションも それを持ちます(セマンティクス参照)。レコードリテラル (#ns.Name{...}・#ns.Name[...]、名前にドットを含むタグ)は、評価しない本体からなる レコードに読まれます(defrecord 参照)。それ以外のタグ(#inst、 #uuid、#my.lib/tag)はタグ付きリテラルです。名前空間マップはキーに名前空間を与えます。 #:user{:id 1 :_/raw 2 name 3} は {:user/id 1 :raw 2 user/name 3} と読まれます(名前空間を 持たないキーワードやシンボルのキーはその名前空間を、_ で修飾されたキーは名前空間なしを取ります)。 #::{...} と #::alias{...} は、キーワードのキーに現在の名前空間か別名の名前空間を与えます。

リーダ条件

.cljc ファイルと REPL は、オラクルと同じくリーダ条件を読みます。#?(:clj a :cljs b) は リーダが持つ最初のフィーチャのフォームとして読まれ、#?@(...) はリストかベクターを外側の コレクションへ展開します。フィーチャは :rontolisp、次にオラクルの :clj、そして :default です。:cljs の分岐は読まれますが組み立てられません(その中の js/x、 #js {...}、:require-macros はプログラムに届きません)。どの分岐も選ばない条件は何も 読まず、トップレベルの展開は拒否されます。.clj ファイルの #? はオラクルと同じ Conditional read not allowed で拒否されます。read-string と read は {:read-cond :allow} を受け取ります(read-string 参照)。

文字

文字は文字として読まれます:\a、小文字の newline/space/tab/return/backspace/ formfeed 名、\uXXXX、\oNNN。バックスラッシュ直後の文字は種類を問わずリテラルの 一部なので、pr がそう綴る \(、\;、\" も読めます。バックスラッシュは リテラルを終えます([\a\b] は2文字です)。それ以外は Unsupported character 拒否です。文字は 可読印刷(pr)では \a、通常印刷(println/str)では a と印字されます。

数

整数は基数付きで読まれます:0xFF は 16 進、2r101 と 8r17 は任意基数 Nr 記法、 先頭 0 は 8 進です。符号は基数接頭辞の外側に付きます。整形はされるが解釈できない トークンは Invalid number 拒否です。

1.50M は 10 進数(オラクルの BigDecimal)です。数字が示すスケールを保ち、目印付きで 印字されます(1.50M、1e3M は 1E+3M)。演算・比較・丸めもオラクルに従います ((+ 0.1M 0.2M) は 0.3M、with-precision で丸めます)。BigDecimal のメソッドにも答えます ((.setScale 1.555M 2 java.math.RoundingMode/HALF_UP) は 1.56M)。long 範囲を超える整数は オラクルの BigInt で、N 付きで印字されます。範囲内の 2N は通常の整数として読まれ、 N なしで印字されます。有理数は 1/2 として読まれます。

##NaN、##Inf、##-Inf は、ソースでも read-string/read でも倍精度数に読まれ、 pr・prn・println は同じ綴りで印字します(コレクションの中でも同じです)。値単体の str と format は NaN、Infinity、-Infinity と綴ります。これ以外の ##名前 は Unknown symbolic value 拒否です。2つの NaN が = になることはなく、1つの値を自分自身と 比べても同じです(オラクルではボックス化された1つの NaN は自分自身と = です。 (def n ##NaN) (= n n))。一方、NaN を含むコレクションは、オラクルと同じく自分自身と = です。NaN をマップや セットのキーにすると、オラクルが同じボックス化オブジェクトしか見つけないのに対し、ここでは値で見つかります。 そのため1つのリテラルで計算された2つの NaN キーは Duplicate key になります(オラクルは両方を残します)。

真偽値、nil、キーワード

true、false、nil は自己評価型です。false は nil とは別のオブジェクトです (仕様との差異参照)。キーワード :foo はその綴りをそのまま(大文字小文字を 保存して)保持するデータで、:a と :A は別物です。コロンの付いた形で印字されます。 名前空間付き :a/b は全体で印刷・比較される不透明なデータです。:: 自動解決は現在の 名前空間に対して解決されます。(ns my.ns) の中の ::kw は :my.ns/kw に、何もなけれ ば :user/kw に、::alias/kw はエイリアス(:require の :as、名前空間自身の名前、 require なしの既知の名前空間)経由です。未知のエイリアスは Invalid token 拒否です。 呼び出し位置のキーワードはマップ参照です -- セマンティクス。

コレクションリテラル

ベクター [1 2 3]、マップ {:a 1}、セット #{1 2}、クオートリスト '(1 2 3) は、 セマンティクスが述べる低下先のリテラルとして読まれます。マップ・セットリテラルは、 先行するキーと = なキーを拒否します(Duplicate key)。{1 :a 1N :b} と #{[1] (1)} は 拒否され、{1 :a 1.0 :b} は拒否されません。評価して初めて等しくなるキーは、オラクルの コンパイラと同じく検査します。キーがすべて定数なら {[1] :a '(1) :b} はプログラムの実行前に 拒否されます(Duplicate constant keys in map)。そうでなければ {(+ 1 2) :a 3 :b} や、x が 1 のときの #{x 1} は、評価した時点で IllegalArgumentException Duplicate key を投げます。 #{[1] '(1)} のような定数のセットは要素を1つ残し、hash-map と hash-set も同様です。

タグ付きリテラル

#inst と #uuid は、フォームを読む時点でオラクルの既定のデータリーダを通して読まれます。 #inst "2020-06-15T10:20:30.456+02:00" はインスタント(オラクルの java.util.Date)、 #uuid "550e8400-e29b-41d4-a716-446655440000" は UUID(オラクルの java.util.UUID)です。 タイムスタンプは yyyy に続けて、省略可能な -MM、-dd、Thh、:mm、:ss、秒の小数部を この順に並べたもので(各部分にはその前の部分がすべて必要です)、最後に省略可能な Z か オフセット +hh:mm・-hh:mm を置きます。1582-10-15 より前の日付は、オラクルと同じく ユリウス暦の日付です。範囲外のフィールド(#inst "2021-02-29")、別の形のタイムスタンプ、 不正な UUID は、オラクルと同じ読み取りエラーになり、その位置は文字列の直後です。 2 つの値の印字・比較・返す値はインスタントと UUID にあります。

#inst "2020-06-15T08:20:30.456-00:00" #uuid "00000001-0001-0001-0001-000000000001"
Wed Jan 01 00:00:00 UTC 2020 1000

それ以外のタグはライブラリのものです。ソースルート(ソースパス 上のディレクトリか jar)にある data_readers.clj か data_readers.cljc が、タグのシンボルを、 それを読む関数の var に対応づけます。オラクルが起動時にマージするのと同じく、すべてのファイルを マージします(.clj のファイルはすべて .cljc のファイルより先です。読むのは最初のフォーム だけで、2 つのファイルが同じタグに別の var を与えると拒否します)。タグ付きリテラルは、ソースを 読む時点で、後ろに読んだフォームを引数にその関数を呼び、答えがリテラルの位置に入ります。データ (ベクター・マップ・セット・レコード・文字列・数・キーワード・#inst・#uuid・パターン)は その値に、リストやシンボルはコードになります。関数はプログラムのコンパイル時に JVM の上で 動くので、wasm 向けでも Java を呼べます。var を名前だけ作って名前空間をロードしないオラクルの 起動と同じく、その名前空間はリテラルより上のフォーム(ns の :require)でロードしなければ ならず、そうでなければリテラルは Attempting to call unbound fn になります。答えが nil なら オラクルの No dispatch macro、ソースで綴れない値(アトム、関数、UUID・Date 以外のホストの オブジェクト)なら Can't embed object in code です。inst や uuid のデータリーダは既定の リーダより先に読み、どのデータリーダも読まないタグにはリーダ関数がありません。実行時の read-string と read はまず *data-readers*(同じマップ)に問い合わせます (read-string 参照)。

$ cat src/data_readers.clj
{geo/point my.geo/point}
$ cat src/my/geo.clj
(ns my.geo)
(defn point [[x y]] {:x x :y y})
$ cat src/app/main.clj
(ns app.main (:require [my.geo]))
(println #geo/point [1 2])
$ rontolisp src/app/main.clj
{:x 1, :y 2}

Read-eval

#=form はプログラムの lowering 中に(コンパイルホスト上で)評価され、その答えが そのフォームのあった位置の datum になります。コンパイル成果物は式ではなく RESULT をリテラルとして運びます。リストのフォームの先頭は現在の名前空間で解決され、残りの引数(未評価のまま)に 関数として適用されます。つまり、サイトより上で定義した定義、コアや既知の ライブラリの値です。特殊フォームは決して解決されず(#=(if true 1 2) は Can't resolve if)、裸のシンボルはそのクラスに答え(#=java.lang.String)、 シンボルでもリストでもないものは Unsupported #= form です。オラクルの読み取りと 同じく、クォートはこれを遮らず('#=(+ 1 2) は 3)、入れ子の #= は先に解決 され、#=(var x) はその var に答えます。*read-eval* が読み取りを守ります(既定で true。#= の読み取り中に nil ならオラクルの EvalReader not allowed when *read-eval* is false です)。

3
42
a1-3