ToC DocOverview CGDoc RelNotes Index PermutedIndex
Allegro CL
Home Previous Up Next Table of Contents Index
  ANSI Common Lisp   14 Conses   14.2 Dictionary of Conses

14.2.26 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

Allegro CL Implementation Details:
None.

Home Previous Up Next Table of Contents Index
© Franz Inc. 1998-2015 - File last updated 03-23-2015