構文
リーダは 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