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 slurp. The latest stable version of Clojure Core is 1.3.0.

doc source examples comments

1.2.0

1.2.0
1.3.0

slurp

clojure.core

(slurp f & opts)

Reads the file named by f using the encoding enc into a string
and returns it.

5 Examples top

link | changes
```
user=> (spit "blubber.txt" "test")
nil
user=> (slurp "blubber.txt")
"test"
```
user=> (spit "blubber.txt" "test") nil user=> (slurp "blubber.txt") "test"
link | changes
```
;; To access web page. Note the use of http://
;; prefix

user=> (slurp "http://clojuredocs.org")
; This will return the html content of clojuredocs.org
```
;; To access web page. Note the use of http:// ;; prefix user=> (slurp "http://clojuredocs.org") ; This will return the html content of clojuredocs.org
link | changes
```
;; Access absolute location on Windows

user=> (slurp "C:\\tasklists.xml")
```
;; Access absolute location on Windows user=> (slurp "C:\\tasklists.xml")
link | changes
```
;; On Linux, some JVMs have a bug where they cannot read a file in the /proc
;; filesystem as a buffered stream or reader.  A workaround to this JVM issue
;; is to open such a file as unbuffered:
(slurp (java.io.FileReader. "/proc/cpuinfo"))
```
;; On Linux, some JVMs have a bug where they cannot read a file in the /proc ;; filesystem as a buffered stream or reader. A workaround to this JVM issue ;; is to open such a file as unbuffered: (slurp (java.io.FileReader. "/proc/cpuinfo"))
link | changes
```
;; You can specify what encoding to use by giving a :encoding param, and an encoding string recognized by your JVM

user=> (slurp "/path/to/file" :encoding "ISO-8859-1")
```
;; You can specify what encoding to use by giving a :encoding param, and an encoding string recognized by your JVM user=> (slurp "/path/to/file" :encoding "ISO-8859-1")

Source clojure/core.clj:5365 top

(defn slurp
  "Reads the file named by f using the encoding enc into a string
  and returns it."
  {:added "1.0"}
  ([f & opts]
     (let [opts (normalize-slurp-opts opts)
           sb (StringBuilder.)]
       (with-open [#^java.io.Reader r (apply jio/reader f opts)]
         (loop [c (.read r)]
           (if (neg? c)
             (str sb)
             (do
               (.append sb (char c))
               (recur (.read r)))))))))

Vars in clojure.core/slurp: char defn let loop neg? str with-open

Used in 2 other vars slurp read-git-ref

Comments top

1 comment(s) for slurp.

mjg123

link

Use slurp also to read an input stream into a string.

ClojureDocs(beta)