unofficial mirror of guile-devel@gnu.org 
 help / color / mirror / Atom feed
From: Kevin Ryde <user42@zip.com.au>
Subject: doco append
Date: Tue, 26 Aug 2003 07:58:21 +1000	[thread overview]
Message-ID: <87fzjpe6wy.fsf@zip.com.au> (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


                 reply	other threads:[~2003-08-25 21:58 UTC|newest]

Thread overview: [no followups] expand[flat|nested]  mbox.gz  Atom feed

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/guile/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87fzjpe6wy.fsf@zip.com.au \
    --to=user42@zip.com.au \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
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).