ToC DocOverview CGDoc RelNotes Index PermutedIndex
Allegro CL version 8.0
Home Previous Up Next Table of Contents Index
  ANSI Common Lisp   14 Conses   14.2 Dictionary of Conses

14.2.22 nth Accessor

Syntax:
nth n list    object

(setf (nth n list) new-object)

Arguments and Values:
n - a non-negative integer.

list - a list, which might be a dotted list or a circular list.

object - an object.

new-object - an object.

Description:
nth locates the nth element of list, where the car of the list is the "zeroth" element. Specifically,

 (nth n list) ==(car (nthcdr n list))

nth may be used to specify a place to setf. Specifically,

 (setf (nth n list) new-object) ==(setf (car (nthcdr n list)) new-object)

Examples:
 (nth 0 '(foo bar baz))   FOO
 (nth 1 '(foo bar baz))   BAR
 (nth 3 '(foo bar baz))   NIL
 (setq 0-to-3 (list 0 1 2 3))  (0 1 2 3)
 (setf (nth 2 0-to-3) "two")  "two"
 0-to-3  (0 1 "two" 3)

See Also:
elt, first, nthcdr

Allegro CL Implementation Details:
None.

Home Previous Up Next Table of Contents Index
© Franz Inc. 1998-2005 - File last updated 6-21-2002