CLCS
src report error
Index
nthcdr Conses Dictionary -
Accessor

rest

rest list ⇒ tail

(setf (rest list) new-tail)

Arguments and Values

lista list, which might be a dotted list or a circular list.
tailan object.

Description

rest performs the same operation as cdr, but mnemonically complements first. Specifically, 

 (rest list) ≡ (cdr list)
 (setf (rest list) new-tail) ≡ (setf (cdr list) new-tail)

Examples

 (rest '(1 2)) ⇒  (2)
 (rest '(1 . 2)) ⇒  2
 (rest '(1)) ⇒  NIL
 (setq *cons* '(1 . 2)) ⇒  (1 . 2)
 (setf (rest *cons*) "two") ⇒  "two"
 *cons* ⇒  (1 . "two")

See Also

cdr, nthcdr

Notes

rest is often preferred stylistically over cdr when the argument is to being subjectively viewed as a list rather than as a cons.

Backlinks

car, cdr, caar, cadr, cdar, cddr, caaar, caadr, cadar, caddr, cdaar, cdadr, cddar, cdddr, caaaar, caaadr, caadar, caaddr, cadaar, cadadr, caddar, cadddr, cdaaar, cdaadr, cdadar, cdaddr, cddaar, cddadr, cdddar, cddddr, Conses as Lists, Conses Dictionary, Function Call Forms as Places, nthcdr, Symbols in the COMMON-LISP Package