Mercurial > emacs

changeset 31131:fe7ff8fb99dc

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Add `last'.
author Dave Love <fx@gnu.org>
date Wed, 23 Aug 2000 14:19:27 +0000
parents e9c859a12e47
children 82bf642db65e
files lispref/lists.texi
diffstat 1 files changed, 8 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/lists.texi	Wed Aug 23 12:05:12 2000 +0000
+++ b/lispref/lists.texi	Wed Aug 23 14:19:27 2000 +0000
@@ -383,6 +383,14 @@
 @end example
 @end defun
 
+@defun last list &optional n
+This function reruns the last link of the given @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
 This function returns the length of @var{list}, with no risk
 of either an error or an infinite loop.