list-ref -- r7rs Definition

§

Kind

§

accessor;

Implemented by

§

• list-ref-car (from vonuvoli);

Procedure signature

§

Procedure variants:

• ((list-not-null range-offset) -> (any))
  • inputs:
    • a value of type list-not-null;
    • a value of type range-offset;
  • output: a value of type any;

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(list-ref list k)

Domain: The list argument can be circular, but it is an error if list has fewer than k elements.

Returns the kth element of list. (This is the same as the car of (list-tail list k).)

(list-ref '(a b c d) 2)           ===>  c
(list-ref '(a b c d)
    (exact (round 1.8)))          ===>  c

---

The text herein was sourced and adapted as described in the "R7RS attribution of various text snippets" appendix.

Referenced-types

§

• list-not-null;
• range-offset;
• any;