string-for-each -- r7rs Definition

§

Kind

§

functor;

Extended by

§

• string-for-each (from vonuvoli);

Procedure signature

§

Procedure variants:

• ((for-each-procedure string |1...|) -> (undefined))
  • inputs:
    • a value of type for-each-procedure;
    • a value of type string;
    • ... -- at least one time;
  • output: a value of type undefined;

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(string-for-each proc string_1 string_2 ...)

Domain: It is an error if proc does not accept as many arguments as there are strings.

The arguments to string-for-each are like the arguments to string-map, but string-for-each calls proc for its side effects rather than for its values. Unlike string-map, string-for-each is guaranteed to call proc on the elements of the lists in order from the first element(s) to the last, and the value returned by string-for-each is unspecified. If more than one string is given and not all strings have the same length, string-for-each terminates when the shortest string runs out. It is an error for proc to mutate any of the strings.

(let ((v '()))
  (string-for-each
   (lambda (c) (set! v (cons (char->integer c) v)))
   "abcde")
  v)                         ===>  (101 100 99 98 97)

---

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

Referenced-types

§

• for-each-procedure;
• string;
• undefined;