User Tools


Function NTHCDR

Syntax

  • nthcdr n listtail

Arguments and Values

Description

Returns the tail of list that would be obtained by calling cdr n times in succession.

Examples

(nthcdr 0 '())

NIL

(nthcdr 3 '())

NIL

(nthcdr 0 '(a b c))

(A B C)

(nthcdr 2 '(a b c))

(C)

(nthcdr 4 '(a b c))

NIL

(nthcdr 1 '(0 . 1))

1

(locally (declare (optimize (safety 3))) (nthcdr 3 '(0 . 1)))

Error: Attempted to take CDR of 1.

Side Effects

None.

Affected By

None.

Exceptional Situations

Should signal an error of type type-error if n is not a non-negative integer.

For n being an integer greater than 1, the error checking done by (nthcdr n list) is the same as for (nthcdr (- n 1) (cdr list)); see the function cdr.

See Also

Example Implementation

To be done.

Notes

None.

\issue{DOTTED-LIST-ARGUMENTS:CLARIFY} \issue{ARGUMENTS-UNDERSPECIFIED:SPECIFY}