append

append Function

Syntax:

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

Expanded Reference: append

tip

TODO: Please contribute to this page by adding explanations and examples

(append )