Clojure Core

Namespaces

clojure
- core
  - protocols
- inspector
- java
  - browse
  - io
  - javadoc
  - shell
- main
- pprint
- repl
- set
- stacktrace
- string
- template
- test
  - junit
  - tap
- walk
- xml
- zip

You're viewing version 1.2.0 of read-string. The latest stable version of Clojure Core is 1.3.0.

doc source examples comments

1.2.0

1.2.0
1.3.0

read-string

clojure.core

(read-string s)

Reads one object from the string s

7 Examples top

link | changes
```
user=> (read-string "1.1")          
1.1

user=> (read-string "1.1.1 (+ 1 1)")
java.lang.RuntimeException: java.lang.NumberFormatException: Invalid number: 1.1.1 (NO_SOURCE_FILE:0)

user=> (read-string "(+ 1 1)")
(+ 1 1)
```
user=> (read-string "1.1") 1.1 user=> (read-string "1.1.1 (+ 1 1)") java.lang.RuntimeException: java.lang.NumberFormatException: Invalid number: 1.1.1 (NO_SOURCE_FILE:0) user=> (read-string "(+ 1 1)") (+ 1 1)
link | changes
```
user=> (eval (read-string "(+ 1 1)"))
2

user=> (read-string (prn-str (+ 1 1)))
2
```
user=> (eval (read-string "(+ 1 1)")) 2 user=> (read-string (prn-str (+ 1 1))) 2
link | changes
```
user=> (+ 11 (read-string "23"))
34
```
user=> (+ 11 (read-string "23")) 34
link | changes
```
;convert a string representing a sequence,
;to the sequence that the string represents
user=> (read-string "(\\( \\x \\y \\) \\z)")
(\( \x \y \) \z)

;then you can convert to the string that the string-sequence represents
user=> (apply str (read-string "(\\( \\x \\y \\) \\z)"))
"(xy)z"

;which is the inverse of
user=> (str (first (list (seq "(xy)z"))))
"(\\( \\x \\y \\) \\z)"
```
;convert a string representing a sequence, ;to the sequence that the string represents user=> (read-string "(\\( \\x \\y \\) \\z)") (\( \x \y \) \z) ;then you can convert to the string that the string-sequence represents user=> (apply str (read-string "(\\( \\x \\y \\) \\z)")) "(xy)z" ;which is the inverse of user=> (str (first (list (seq "(xy)z")))) "(\\( \\x \\y \\) \\z)"
link | changes
```
user=> (read-string "; foo\n5")
5

user=> (read-string "#^String x")
x

user=> (read-string "(1)")
(1)

user=> (read-string "(+ 1 2) (- 3 2)")
(+ 1 2)

user=> (read-string "@a")
(clojure.core/deref a)

user=> (read-string "(+ 1 2))))))")
(+ 1 2)

user=> (read-string "::whatever-namespace-you-are-in")
:user/whatever-namespace-you-are-in
```
user=> (read-string "; foo\n5") 5 user=> (read-string "#^String x") x user=> (read-string "(1)") (1) user=> (read-string "(+ 1 2) (- 3 2)") (+ 1 2) user=> (read-string "@a") (clojure.core/deref a) user=> (read-string "(+ 1 2))))))") (+ 1 2) user=> (read-string "::whatever-namespace-you-are-in") :user/whatever-namespace-you-are-in
link | changes
```
;; you can think of read-string as the inverse of pr-str
;; turn string into symbols
user=> (read-string "(a b foo :bar)")
(a b foo :bar)

;;turn symbols into a string
user=> (pr-str '(a b foo :bar))
"(a b foo :bar)"
```
;; you can think of read-string as the inverse of pr-str ;; turn string into symbols user=> (read-string "(a b foo :bar)") (a b foo :bar) ;;turn symbols into a string user=> (pr-str '(a b foo :bar)) "(a b foo :bar)"
link | changes
```
;; WARNING: You SHOULD NOT use clojure.core/read-string to read data from
;; untrusted soures.  See the examples for clojure.core/read, because the same
;; issues exist for both read and read-string.
```
;; WARNING: You SHOULD NOT use clojure.core/read-string to read data from ;; untrusted soures. See the examples for clojure.core/read, because the same ;; issues exist for both read and read-string.

Source clojure/core.clj:2894 top

(defn read-string
  "Reads one object from the string s"
  {:added "1.0"}
  [s] (clojure.lang.RT/readString s))

Vars in clojure.core/read-string: defn

Used in 3 other vars swank init-inspector stringify-sandbox

Comments top

1 comment(s) for read-string.

boxie

link

read-string is useful for running clojure code from a script or translator.

ClojureDocs(beta)