append (ANSI and GNU Common Lisp Document)

Next: revappend, Previous: nconc, Up: Conses Dictionary

#### 14.2.26 append [Function]

`append` &rest lists ⇒ result

#### Arguments and Values::

list—each must be a proper list except the last, which may be any object.

result—an object. This will be a list unless the last list was not a list and all preceding lists were null.

#### Description::

append returns a new list that is the concatenation of the copies. lists are left unchanged; the list structure of each of lists except the last is copied. The last argument is not copied; it becomes the cdr of the final dotted pair of the concatenation of the preceding lists, or is returned directly if there are no preceding non-empty lists.

#### Examples::

     (append '(a b c) '(d e f) '() '(g)) ⇒  (A B C D E F G)
     (append '(a b c) 'd) ⇒  (A B C . D)
     (setq lst '(a b c)) ⇒  (A B C)
     (append lst '(d)) ⇒  (A B C D)
     lst ⇒  (A B C)
     (append) ⇒  NIL
     (append 'a) ⇒  A

#### See Also::

nconc , concatenate