|  | ANSI Common Lisp  14 Conses  14.2 Dictionary of Conses 
 
 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
Allegro CL Implementation Details:
 None. |