In Clojure, what does `&` mean in function/macro signature?

Question

I saw the usage of & in Clojure function signature like this (http://clojure.github.io/core.async/#clojure.core.async/thread):

(thread & body)

And this:

(doseq seq-exprs & body)

Does that means the function/macro can accept a list as variable? I also find * is often used to mean multiple parameters can be accepted, like this:

(do exprs*)

Does anyone have ideas about the difference between & and * in function/macro signature? Is there any documentation to explain this syntax?

Answer 1

In clojure binding forms (let, fn, loop, and their progeny), you can bind the rest of a binding vector to a sequence with a trailing &. For instance,

(let [[a b & xs] (range 5)] xs) ;(2 3 4)

Uses of * and other uses of & are conventions for documenting the structure of argument lists.

Answer 2

It means that there can be multiple parameters after the ampersand, and they will be seen as a seq by the function. Example:

(defn g [a & b]
  (println a b))

Then if you call:

 (g 1 2 3 4)

it will print out 1 (2 3 4) (a is 1, b is a sequence containing 2, 3 and 4).