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]