clojure.core/slurp

View this page on ClojureDocs

Type: function Added: Clojure 1.0 Examples: 7 Runnable: 2

([f & opts])

Opens a reader on f and reads all its contents, returning a string. See clojure.java.io/reader for a complete list of supported arguments.

Examples

by pkolloch on 2010-07-30 . May have evaluation errors. ▶

(spit "blubber.txt" "test") nil (slurp "blubber.txt") "test"

by OnesimusUnbound on 2011-08-24 ▶

;; To access web page. Note the use of https:// ;; prefix (slurp "https://clojuredocs.org") ; This will return the html content of clojuredocs.org

by Havvy on 2011-08-25 . May have evaluation errors. ▶

;; Access absolute location on Windows (slurp "C:\\tasklists.xml")

by jafingerhut on 2012-02-25 . May have evaluation errors. ▶

;; 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"))

by nils.grunwald on 2012-07-13 . May have evaluation errors. ▶

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

by freckletonj on 2016-05-27 ▶

;; you can fetch URLs (slurp "http://www.example.com")

by mhmdsalem1993 on 2017-01-29 . May have evaluation errors. ▶

;; you can read bytes also (def arr-bytes (into-array Byte/TYPE (range 128))) (slurp arr-bytes)

Note by mjg123

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

Note by roryokane

With link: “See clojure.java.io/reader for a complete list of supported arguments.â€�

According to those docs, here are the supported types for f, the object to read:

• Reader
• BufferedReader
• InputStream
• File
• URI
• URL
• Socket
• byte arrays (byte[])
• character arrays (char[])
• String

slurp can read objects of any of these types into a string.

Note by nevesjorgelucio

(defn slurp-bytes
  "Slurp the bytes from a slurpable thing"
  [x]
  (with-open [out (java.io.ByteArrayOutputStream.)]
    (clojure.java.io/copy (clojure.java.io/input-stream x) out)
    (.toByteArray out)))

Note by didibus

Valid options include:

:encoding  string name of encoding to use, e.g. \"UTF-8\".

Note by piranha

(defn slurp-norm
  "When the file is incoming with \r\n newlines"
  [file]
  (with-open [rdr (io/reader file)]
    (str/join "\n" (line-seq rdr))))

See also

• clojure.java.io/reader (0)
• clojure.core/spit (1)
• clojure.java.io/resource (0)

---

Content from the matching ClojureDocs page, with authors credited on each contribution.