From: Dave Love <fx@gnu.org>
Date: Wed, 23 Aug 2000 14:19:27 +0000 (+0000)
Subject: Add `last'.
X-Git-Tag: emacs-pretest-21.0.90~2011
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=dbda27d1f9ba40181f52d2e93218b54181d93c5a;p=emacs.git

Add `last'.
---

diff --git a/lispref/lists.texi b/lispref/lists.texi
index 64e634d2803..458d011c489 100644
--- a/lispref/lists.texi
+++ b/lispref/lists.texi
@@ -383,6 +383,14 @@ If @var{n} is zero or negative, @code{nthcdr} returns all of
 @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.