clojure.core/seq

View this page on ClojureDocs

Type: function Added: Clojure 1.0 Examples: 5 Runnable: 5

([coll])

Returns a seq on the collection. If the collection is empty, returns nil. (seq nil) returns nil. seq also works on Strings, native Java arrays (of reference types) and any objects that implement Iterable. Note that seqs cache values, thus seq should not be used on any Iterable whose iterator repeatedly returns the same mutable object.

Examples

by devn on 2010-08-02 ▶

(seq '(1)) ;;=> (1) (seq [1 2]) ;;=> (1 2) (seq "abc") ;;=> (\a \b \c) ;; Corner cases (seq nil) ;;=> nil (seq '()) ;;=> nil (seq []) ;;=> nil (seq "") ;;=> nil

by dansalmo on 2012-10-15 ▶

;; (seq x) is the recommended idiom for testing if a collection is not empty (every? seq ["1" [1] '(1) {:1 1} #{1}]) ;;=> true

by rafmagana on 2013-10-01 ▶

;; 'seq' can be used to turn a map into a list of vectors. ;; Notice how the list is built adding elements to the beginning ;; of the seq (list) not to the end, as with vectors. ;; (Of course, the order that items are ;; taken from a map should not be relied upon ;; unless a deterministic 'sorted-map' is used.) (seq {:key1 "value1" :key2 "value2"}) ;;=> ([:key2 "value2"] [:key1 "value1"])

by ertugrulcetin on 2016-08-11 ▶

;; Here is the difference between seq and sequence (seq nil) ;;=> nil (seq ()) ;;=> nil (sequence ()) ;;=> () (sequence nil) ;;=> ()

by bfontaine on 2020-10-09 ▶

;; seq is very similar to not-empty: (every? seq ["1" [1] '(1) {:1 1} #{1}]) ;;=> true (every? not-empty ["1" [1] '(1) {:1 1} #{1}]) ;;=> true (seq '(1)) ;;=> (1) (not-empty '(1)) ;;=> (1) (seq [1 2]) ;;=> (1 2) (not-empty [1 2]) ;;=> [1 2] (seq "abc") ;;=> (\a \b \c) (not-empty "abc") ;;=> "abc" (map seq [nil '() [] "" {}]) ;;=> (nil nil nil nil nil) (map not-empty [nil '() [] "" {}]) ;;=> (nil nil nil nil nil)

See also

• clojure.core/seq? (2)
• clojure.core/empty? (5)
• clojure.core/iterator-seq (0)
• clojure.core/seqable? (0)
• clojure.core/sequential? (1)
• clojure.core/sequence (1)

---

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