* doco append
@ 2003-08-25 21:58 Kevin Ryde
0 siblings, 0 replies; only message in thread
From: Kevin Ryde @ 2003-08-25 21:58 UTC (permalink / raw)
A bit of a revision for append and append!,
* scheme-compound.texi (Append/Reverse): Merge append and append!,
show parameters as lst1 ... lstN, describe list argument for
scm_append and scm_append_x and note that it's unmodified.
- Scheme Procedure: append lst1 ... lstN
- Scheme Procedure: append! lst1 ... lstN
- C Function: scm_append (lstlst)
- C Function: scm_append_x (lstlst)
Return a list comprising all the elements lists LST1 to LSTN.
(append '(x) '(y)) => (x y)
(append '(a) '(b c d)) => (a b c d)
(append '(a (b)) '((c))) => (a (b) (c))
The last argument LSTN may actually be any object; an improper
list results if the last argument is not a proper list.
(append '(a b) '(c . d)) => (a b c . d)
(append '() 'a) => a
`append' doesn't modify the given lists, but the return may share
structure with the final LSTN. `append!' modifies the lists to
form its return.
For `scm_append' and `scm_append_x', LSTLST is a list of the lists
LST1 ... LSTN. That LSTLST itself is not modified or used in the
return.
_______________________________________________
Guile-devel mailing list
Guile-devel@gnu.org
http://mail.gnu.org/mailman/listinfo/guile-devel
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2003-08-25 21:58 UTC | newest]
Thread overview: (only message) (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2003-08-25 21:58 doco append Kevin Ryde
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).