make-list (ANSI and GNU Common Lisp Document)

Next: push, Previous: listp, Up: Conses Dictionary

#### 14.2.18 make-list [Function]

`make-list` size &key initial-element ⇒ list

#### Arguments and Values::

size—a non-negative integer.

initial-element—an object. The default is nil.

list—a list.

#### Description::

Returns a list of length given by size, each of the elements of which is initial-element.

#### Examples::

     (make-list 5) ⇒  (NIL NIL NIL NIL NIL)
     (make-list 3 :initial-element 'rah) ⇒  (RAH RAH RAH)
     (make-list 2 :initial-element '(1 2 3)) ⇒  ((1 2 3) (1 2 3))
     (make-list 0) ⇒  NIL ;i.e., ()
     (make-list 0 :initial-element 'new-element) ⇒  NIL

#### Exceptional Situations::

Should signal an error of type type-error if size is not a non-negative integer.

#### See Also::

cons , list (Function)