Next: , Previous: String Searching, Up: Strings

5.5.5.9 Alphabetic Case Mapping

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

— 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.