create reader from string

(type (create “hello world”)) => clojure.tools.reader.reader_types.IndexingPushbackReader

returns nil and moves reader one char forward

(->> ignore-char (read-repeatedly (create “abc”)) (take 3) (apply str)) => ""

returns the current reader char with moving

(->> (read-times (create “abc”) peek-char 3) (apply str)) => “aaa”

reads single char and move forward

(->> read-char (read-repeatedly (create “abc”)) (take 3) (apply str)) => “abc”

reads up to a given predicate

(read-include (create " a") read-char (complement check/voidspace?)) => [\space \space \a]

reads input repeatedly

(->> (read-repeatedly (create “abcdefg”) #(str (read-char %) (read-char %)) empty?) (take 5)) => “ab” “cd” “ef” “g”

reads input repeatedly

(->> (read-times (create “abcdefg”) #(str (read-char %) (read-char %)) 2)) => “ab” “cd”

reads to an input boundary

(read-to-boundary (create “abc efg”)) => “abc”

reads inputs until the predicate is reached

(read-until (create “abcde”) (fn ch (= (str ch) “d”))) => “abc”

reads input while the predicate is true

(read-while (create “abcde”) (fn ch (not= (str ch) “d”))) => “abc”

returns the position of the reader

(-> (create “abc”) step-char step-char reader-position) => 1 3

reads rest of input from reader

(reader/slurp (reader/step-char (create “abc efg”))) => “bc efg”

moves reader one char forward

(-> (create “abc”) step-char read-char str) => “b”

throws a reader message

(throw-reader (create “abc”) “Message” {:data true}) => (throws)

move reader one char back, along with char

(-> (create “abc”) (step-char) (unread-char \A) (reader/slurp)) => “Abc”