string-set! -- r7rs Definition

§

Kind

§

mutator!;

Extended by

§

• string-set! (from vonuvoli);

Procedure signature

§

Procedure variants:

• ((string-not-empty range-offset character) -> (undefined))
  • inputs:
    • a value of type string-not-empty;
    • a value of type range-offset;
    • a value of type character;
  • output: a value of type undefined;

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(string-set! string k char)

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

The string-set! procedure stores char in element k of string. There is no requirement for this procedure to execute in constant time.

(define (f) (make-string 3 #\*))
(define (g) "***")
(string-set! (f) 0 #\?)  ===>  #unspecified
(string-set! (g) 0 #\?)  ===>  #error
(string-set! (symbol->string 'immutable)
             0
             #\?)        ===>  #error

Note: There is no requirement for this procedure to execute in constant time.

---

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

Referenced-types

§

• string-not-empty;
• range-offset;
• character;
• undefined;