clojure.core/first

View this page on ClojureDocs

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

([coll])

Returns the first item in the collection. Calls seq on its argument. If coll is nil, returns nil.

Examples

by dpritchett on 2010-07-14 ▶

(first '(:alpha :bravo :charlie)) ;;=> :alpha

by belun on 2011-04-24 ▶

;; nil is a valid (but empty) collection. (first nil) ;;=> nil ;; if collection is empty, returns nil. (first []) ;;=> nil ;; if first item in collection is nil, returns nil (first [nil]) ;;=> nil

by Juve-yescas on 2017-05-03 . May have evaluation errors. ▶

=> (first [1 2]) 1 => (first [ [1 2] [3 4] ]) [1 2]

by zuzhi on 2022-08-21 . May have evaluation errors. ▶

=> (first "j") \j => (int (first "j")) 106

See also

• clojure.core/rest (6)
• clojure.core/next (2)
• clojure.core/nth (1)
• clojure.core/second
• clojure.core/take (3)
• clojure.core/ffirst (2)
• clojure.core/butlast (4)
• clojure.core/peek (3)

---

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