(rontolisp) docs
← IO

read-string

(read-string s) / (read-string opts s)

Reads the first datum of the string and answers it as data: what a quote of the same text answers, so (= (read-string "[1 :k]") '[1 :k]) holds. Numbers, strings, characters, keywords (::kw in the calling namespace), symbols, lists, vectors, maps and sets read like the source reader reads them, namespace maps (#:ns{...}, #::{...}) included; reader metadata attaches like the oracle's (^:k is {:k true}, a symbol or string {:tag x}, a vector {:param-tags v}, on a symbol too) and #_ discards. A repeated map key or set member is the oracle's Duplicate key, and a keyword or symbol the oracle does not read (a:, x/, //) its Invalid token. A record literal (#ns.Name{...} / #ns.Name[...], a dotted name) builds the record of a class the program defines, over its unevaluated body. Any other tag reads like the oracle's: through the function *data-readers* maps its symbol to (the program's data readers, which binding replaces), else #inst and #uuid into their values, else through *default-data-reader-fn* of the tag and the value; a tag none of them reads has no reader function, and a nil answer is No dispatch macro. Text after the first datum is ignored. Empty input signals EOF while reading, unless the options map has an :eof entry, which is then the answer. Reader conditionals are refused (Conditional read not allowed) unless the options map holds :read-cond :allow; then they read like in a .cljc file, a :features set adding features to :rontolisp, :clj and :default. Under :read-cond :preserve a #?(...)/#?@(...) reads as a reader-conditional over the whole list, and a tagged literal inside one as a tagged-literal. #= read-time evaluation is refused like in source, and @x reads (deref x) like '@x does (the oracle: (clojure.core/deref x)). Runs on every backend; as a value, one or two arguments.

[1 :k s (a b)]
true
:none
[2 3 4]
1
#?(:cljs #js {} :clj 2)
[:tagged 1]
[foo/bar 2]