list-set! -- r7rs Definition

§

Kind

§

mutator!;

Extended by

§

• list-set-car! (from vonuvoli);

Procedure signature

§

Procedure variants:

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

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(list-set! list k obj)

Domain: It is an error if k is not a valid index of list.

The list-set! procedure stores obj in element k of list.

(let ((ls (list 'one 'two 'five!)))
  (list-set! ls 2 'three)
  ls)      ===>  (one two three)

(list-set! '(0 1 2) 1 "oops")  ===>  #error  ; constant list

---

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;
• undefined;