clojure.core/list*

View this page on ClojureDocs

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

([args] [a args] [a b args] [a b c args] [a b c d & more])

Creates a new seq containing the items prepended to the rest, the last of which will be treated as a sequence.

Examples

by Dimagog on 2010-08-02 . May have evaluation errors. ▶

;; `list*` function: (list* 1 [2 3]) (1 2 3) (list* 1 2 [3 4]) (1 2 3 4) ;; compared to regular `list` function: (list 1 [2 3]) (1 [2 3]) (list 1 2 [3 4]) (1 2 [3 4]) ;; Corner cases: (list* nil [1 2]) (nil 1 2) (list* 1 nil) (1) (list* () [1 2]) (() 1 2) (list* 1 ()) (1)

by Manishapillai on 2016-09-19 ▶

;;Prepend a map to a list (list* {:name "Anne"} [{:city "NJ"}]) ({:name "Anne"} {:city "NJ"})

by smnplk on 2017-06-01 ▶

;; Useful if you want to get all the arguments of a function into a list (actually a seq, but that is not important) (defn args-to-list [a b c & args] (list* a b c args)) (args-to-list 1 2 3 4 5 6) (1 2 3 4 5 6) ;; same as list, but it expects the last element to be a sequence which is then unpacked ;; Example usage in the wild (defn my-max ([a] a) ([a b] (if (> a b) a b)) ([a b & args] (reduce my-max (list* a b args))))

by arlicle on 2018-09-04 ▶

;; `list*` function: (list* 1 '(2 3)) (1 2 3) (list* 1 2 '(3 4)) (1 2 3 4)

by Chandrama1 on 2023-01-07 . May have evaluation errors. ▶

;; `list*` function: (list* "Superman" '("Batman" "Ironman")) => ("Superman" "Batman" "Ironman") (list* '("Batman" "Ironman") '("Superman" "Hulk")) => (("Batman" "Ironman") "Superman" "Hulk") (list* '("Batman" "Ironman") "Superman") => (("Batman" "Ironman") \S \u \p \e \r \m \a \n)

Note by miner

The doc string mentions returning a new list, but it should say a new sequence. Surprisingly, list* typically does not return an actual list. Instead, it usually returns a Cons, which works as a seq, but is not strictly a list.

(list? (list* 1 '(2 3)))
;=> false

(type (list* 1 '(2 3)))
;=> clojure.lang.Cons

(first (list* 1 '(2 3)))
;=> 1

(peek (list* 1 '(2 3)))
ClassCastException clojure.lang.Cons cannot be cast to clojure.lang.IPersistentStack

(list? (list* '(2 3)))
;=> true

(list? (into () (list* 1 '(2 3))))
;=> true

I think seq* would have been a better name for this function.

---

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