string-map -- r7rs Definition

§

Kind

§

functor;

Implemented by

§

• string-map (from vonuvoli);

Procedure signature

§

Procedure variants:

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

Exports

§

• scheme:base -- (scheme base);

Exports recursive

§

• scheme -- (scheme);

Description

§

(string-map proc string_1 string_2 ...)

Domain: It is an error if proc does not accept as many arguments as there are strings and return a single character.

The string-map procedure applies proc element-wise to the elements of the strings and returns a string of the results, in order. If more than one string is given and not all strings have the same length, string-map terminates when the shortest string runs out. The dynamic order in which proc is applied to the elements of the strings is unspecified. If multiple returns occur from string-map, the values returned by earlier returns are not mutated.

(string-map char-foldcase "AbdEgH") ===>  "abdegh"

(string-map
 (lambda (c)
   (integer->char (+ 1 (char->integer c))))
 "HAL")                ===>  "IBM"

(string-map
 (lambda (c k)
   ((if (eqv? k #\u) char-upcase char-downcase)
    c))
 "studlycaps xxx"
 "ululululul")   ===>   "StUdLyCaPs"

---

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

Referenced-types

§

• map-procedure;
• string;
• any;