69 lines
2 KiB
HTML
69 lines
2 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3O//DTD W3 HTML 2.0//EN">
|
||
|
|
<!Originally converted to HTML using LaTeX2HTML 95 (Thu Jan 19 1995) by Nikos Drakos (nikos@cbl.leeds.ac.uk), CBLU, University of Leeds >
|
||
|
|
<HEAD>
|
||
|
|
<TITLE> append (FUNCTION)</TITLE>
|
||
|
|
</HEAD>
|
||
|
|
<BODY>
|
||
|
|
<meta name="description" value=" append (FUNCTION)">
|
||
|
|
<meta name="keywords" value="lp">
|
||
|
|
<meta name="resource-type" value="document">
|
||
|
|
<meta name="distribution" value="global">
|
||
|
|
<P>
|
||
|
|
<BR> <HR>
|
||
|
|
<A HREF="node81.html"><IMG ALIGN=BOTTOM ALT="next" SRC="next_motif.gif"></A>
|
||
|
|
<A HREF="node72.html"><IMG ALIGN=BOTTOM ALT="up" SRC="up_motif.gif"></A>
|
||
|
|
<A HREF="node79.html"><IMG ALIGN=BOTTOM ALT="previous" SRC="previous_motif.gif"></A> <BR>
|
||
|
|
<A HREF="lp.html"><B>Contents</B></A>
|
||
|
|
<B> Next:</B>
|
||
|
|
<A HREF="node81.html"> apply (FUNCTION)</A>
|
||
|
|
<B>Up:</B>
|
||
|
|
<A HREF="node72.html"> Appendix: Selected Lisp </A>
|
||
|
|
<B> Previous:</B>
|
||
|
|
<A HREF="node79.html"> and (MACRO)</A>
|
||
|
|
<BR> <HR> <P>
|
||
|
|
<H1> append (FUNCTION)</H1>
|
||
|
|
<P>
|
||
|
|
<b> Format:</b>
|
||
|
|
<tt> (append <list1> <list2> ...<listN> <exp> )</tt>
|
||
|
|
<P>
|
||
|
|
<b> Required arguments:</b>
|
||
|
|
none
|
||
|
|
<P>
|
||
|
|
<b> Optional arguments:</b>
|
||
|
|
zero or more Lisp expressions
|
||
|
|
<P>
|
||
|
|
<tt> <list> </tt>: any Lisp expression which returns a list; except the last argument may be <em> any</em> Lisp expression.
|
||
|
|
<P>
|
||
|
|
Each of the arguments is evaluated; all except the last must return a list. If all the arguments evaluate to lists, append creates a new list which has as its elements the elements of all the argument lists. If the last argument is not a list, append returns a dotted pair object.
|
||
|
|
<P>
|
||
|
|
<b> Examples:</b>
|
||
|
|
<P>
|
||
|
|
<BLOCKQUOTE>
|
||
|
|
<PRE>> (append '(a b) '(c d))
|
||
|
|
(A B C D)
|
||
|
|
|
||
|
|
> (append '(1 (2 (3))) '(i (j) k))
|
||
|
|
(1 (2 (3)) I (J) K)
|
||
|
|
|
||
|
|
> (setq tmp '(fee fi fo))
|
||
|
|
(FEE FI FO)
|
||
|
|
|
||
|
|
> (append tmp (list 'fum))
|
||
|
|
(FEE FI FO FUM)
|
||
|
|
|
||
|
|
> (append '(fo) 'fum)
|
||
|
|
(FO . FUM) ;; this is a dotted pair
|
||
|
|
|
||
|
|
> (append 'a '(1 2))
|
||
|
|
Error: A is not of type LIST
|
||
|
|
</PRE>
|
||
|
|
</BLOCKQUOTE>
|
||
|
|
<P>
|
||
|
|
<BR> <HR>
|
||
|
|
<P>
|
||
|
|
<ADDRESS>
|
||
|
|
<I>© Colin Allen & Maneesh Dhagat <BR>
|
||
|
|
March 2007 </I>
|
||
|
|
</ADDRESS>
|
||
|
|
</BODY>
|