string-upcase -- r7rs Definition

§

Kind

§

procedure;

Implemented by

§

• string-upcase (from vonuvoli);

Procedure signature

§

Procedure variants:

• ((string-empty) -> (string-empty))
  • input: a value of type string-empty;
  • output: a value of type string-empty;
• ((string-not-empty) -> (string-not-empty))
  • input: a value of type string-not-empty;
  • output: a value of type string-not-empty;

Exports

§

• scheme:char -- (scheme char);

Exports recursive

§

• scheme -- (scheme);

Description

§

(string-upcase string)
(string-downcase string)
(string-foldcase string)

These procedures apply the Unicode full string uppercasing, lowercasing, and case-folding algorithms to their arguments and return the result. In certain cases, the result differs in length from the argument. If the result is equal to the argument in the sense of string=?, the argument may be returned. Note that language-sensitive mappings and foldings are not used.

The Unicode Standard prescribes special treatment of the Greek letter Σ, whose normal lower-case form is σ but which becomes ς at the end of a word. See UAX #29 (part of the Unicode Standard) for details. However, implementations of string-downcase are not required to provide this behavior, and may choose to change Σ to σ in all cases.

---

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

Referenced-types

§

• string-empty;
• string-not-empty;