Node:Alphabetic Case Mapping, Next:, Previous:String Searching, Up:Strings


21.4.9 Alphabetic Case Mapping

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

string-upcase str Scheme Procedure
scm_string_upcase (str) C Function
Return a freshly allocated string containing the characters of str in upper case.

string-upcase! str Scheme Procedure
scm_string_upcase_x (str) C Function
Destructively upcase every character in str and return str. 
y                  => "arrdefg"
(string-upcase! y) => "ARRDEFG"
y                  => "ARRDEFG"

string-downcase str Scheme Procedure
scm_string_downcase (str) C Function
Return a freshly allocation string containing the characters in str in lower case.

string-downcase! str Scheme Procedure
scm_string_downcase_x (str) C Function
Destructively downcase every character in str and return str. 
y                     => "ARRDEFG"
(string-downcase! y)  => "arrdefg"
y                     => "arrdefg"

string-capitalize str Scheme Procedure
scm_string_capitalize (str) C Function
Return a freshly allocated string with the characters in str, where the first character of every word is capitalized.

string-capitalize! str Scheme Procedure
scm_string_capitalize_x (str) C Function
Upcase the first character of every word in str destructively and return str. 
y                      => "hello world"
(string-capitalize! y) => "Hello World"
y                      => "Hello World"