guile-devel
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

doco append


From: Kevin Ryde
Subject: doco append
Date: Tue, 26 Aug 2003 07:58:21 +1000
User-agent: Gnus/5.090019 (Oort Gnus v0.19) Emacs/21.3 (gnu/linux)

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.




reply via email to

[Prev in Thread] Current Thread [Next in Thread]