6.6.5.9 Alphabetic Case Mapping

These are procedures for mapping strings to their upper- or lower-case equivalents, respectively, or for capitalizing strings.

They use the basic case mapping rules for Unicode characters. No special language or context rules are considered. The resulting strings are guaranteed to be the same length as the input strings.

See the (ice-9 i18n) module, for locale-dependent case conversions.

Scheme Procedure: string-upcase str [start [end]]

C Function: scm_substring_upcase (str, start, end)

C Function: scm_string_upcase (str)

Upcase every character in str.

Scheme Procedure: string-upcase! str [start [end]]

C Function: scm_substring_upcase_x (str, start, end)

C Function: scm_string_upcase_x (str)

Destructively upcase every character in str.

(string-upcase! y)
⇒ "ARRDEFG"
y
⇒ "ARRDEFG"

Scheme Procedure: string-downcase str [start [end]]

C Function: scm_substring_downcase (str, start, end)

C Function: scm_string_downcase (str)

Downcase every character in str.

Scheme Procedure: string-downcase! str [start [end]]

C Function: scm_substring_downcase_x (str, start, end)

C Function: scm_string_downcase_x (str)

Destructively downcase every character in str.

y
⇒ "ARRDEFG"
(string-downcase! y)
⇒ "arrdefg"
y
⇒ "arrdefg"

Scheme Procedure: string-capitalize str

C Function: scm_string_capitalize (str)

Return a freshly allocated string with the characters in str, where the first character of every word is capitalized.

Scheme Procedure: string-capitalize! str

C Function: scm_string_capitalize_x (str)

Upcase the first character of every word in str destructively and return str.

y                      ⇒ "hello world"
(string-capitalize! y) ⇒ "Hello World"
y                      ⇒ "Hello World"

Scheme Procedure: string-titlecase str [start [end]]

C Function: scm_string_titlecase (str, start, end)

Titlecase every first character in a word in str.

Scheme Procedure: string-titlecase! str [start [end]]

C Function: scm_string_titlecase_x (str, start, end)

Destructively titlecase every first character in a word in str.