[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to emacs/lispref/lists.texi [lexbind]
From: |
Miles Bader |
Subject: |
[Emacs-diffs] Changes to emacs/lispref/lists.texi [lexbind] |
Date: |
Tue, 14 Oct 2003 19:10:17 -0400 |
Index: emacs/lispref/lists.texi
diff -c emacs/lispref/lists.texi:1.32.8.1 emacs/lispref/lists.texi:1.32.8.2
*** emacs/lispref/lists.texi:1.32.8.1 Fri Apr 4 01:20:42 2003
--- emacs/lispref/lists.texi Tue Oct 14 19:10:12 2003
***************
*** 384,394 ****
@end defun
@defun last list &optional n
! This function returns the last link of @var{list}. The
! @code{car} of this link is the list's last element. If @var{list} is
! null, @code{nil} is returned. If @var{n} is non-nil the
! @var{n}-th-to-last link is returned instead, or the whole @var{list} if
! @var{n} is bigger than @var{list}'s length.
@end defun
@defun safe-length list
--- 384,394 ----
@end defun
@defun last list &optional n
! This function returns the last link of @var{list}. The @code{car} of
! this link is the list's last element. If @var{list} is null,
! @code{nil} is returned. If @var{n} is address@hidden, the
! @var{n}th-to-last link is returned instead, or the whole of @var{list}
! if @var{n} is bigger than @var{list}'s length.
@end defun
@defun safe-length list
***************
*** 733,738 ****
--- 733,764 ----
destructively. See @ref{Sets And Lists}.
@end defun
+ @defun copy-tree tree &optional vecp
+ This function returns a copy the tree @code{tree}. If @var{tree} is a
+ cons cell, this makes a new cons cell with the same @sc{car} and
+ @sc{cdr}, then recursively copies the @sc{car} and @sc{cdr} in the
+ same way.
+
+ Normally, when @var{tree} is anything other than a cons cell,
+ @code{copy-tree} simply returns @var{tree}. However, if @var{vecp} is
+ address@hidden, it copies vectors too (and operates recursively on
+ their elements).
+ @end defun
+
+ @defun number-sequence from to &optional separation
+ This returns a list of numbers starting with @var{from}
+ and incrementing by @var{separation} (or by 1 if @var{separation}
+ is @code{nil} or omitted), and ending at or just before @var{to}.
+ For example,
+
+ @example
+ (number-sequence 4 9)
+ @result{} (4 5 6 7 8 9)
+ (number-sequence 1.5 6 2)
+ @result{} (1.5 3.5 5.5)
+ @end example
+ @end defun
+
@node Modifying Lists
@section Modifying Existing List Structure
@cindex destructive list operations
***************
*** 1644,1656 ****
@defun assq-delete-all key alist
@tindex assq-delete-all
This function deletes from @var{alist} all the elements whose @sc{car}
! is @code{eq} to @var{key}. It returns @var{alist}, modified
! in this way. Note that it modifies the original list structure
! of @var{alist}.
@example
! (assq-delete-all 'foo
! '((foo 1) (bar 2) (foo 3) (lose 4)))
@result{} ((bar 2) (lose 4))
@end example
@end defun
--- 1670,1691 ----
@defun assq-delete-all key alist
@tindex assq-delete-all
This function deletes from @var{alist} all the elements whose @sc{car}
! is @code{eq} to @var{key}, much as if you used @code{delq} to delete
! such each element one by one. It returns the shortened alist, and
! often modifies the original list structure of @var{alist}. For
! correct results, use the return value of @code{assq-delete-all} rather
! than looking at the saved value of @var{alist}.
@example
! (setq alist '((foo 1) (bar 2) (foo 3) (lose 4)))
! @result{} ((foo 1) (bar 2) (foo 3) (lose 4))
! (assq-delete-all 'foo alist)
@result{} ((bar 2) (lose 4))
+ alist
+ @result{} ((foo 1) (bar 2) (lose 4))
@end example
@end defun
+
+ @ignore
+ arch-tag: 31fb8a4e-4aa8-4a74-a206-aa00451394d4
+ @end ignore
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [Emacs-diffs] Changes to emacs/lispref/lists.texi [lexbind],
Miles Bader <=