String Functions

(string <expr>)  MAKE A STRING FROM A CHARACTER, SYMBOL OR STRING.
    <expr>      the expression.
    returns     a string.  Calling string on a string argument is a no-op.

(string-trim <bag> <str>)  TRIM BOTH ENDS OF A STRING
    <bag>       a string containing characters to trim
    <str>       the string to trim
    returns     a trimmed copy of the string

(string-left-trim <bag> <str>)  TRIM THE LEFT END OF A STRING
    <bag>       a string containing characters to trim
    <str>       the string to trim
    returns     a trimed copy of the string

(string-right-trim <bag> <str>)  TRIM THE RIGHT END OF A STRING
    <bag>       a string containing characters to trim
    <str>       the string to trim
    returns     a trimed copy of the string

(string-upcase <str> &key :start :end)  CONVERT TO UPPERCASE
    <str>       the string
    :start      the starting offset
    :end        the ending offset + 1
    returns     a converted copy of the string

(string-downcase <str> &key :start :end)  CONVERT TO LOWERCASE
    <str>       the string
    :start      the starting offset
    :end        the ending offset + 1
    returns     a converted copy of the string

(nstring-upcase <str> &key :start :end)  CONVERT TO UPPERCASE
    <str>       the string
    :start      the starting offset
    :end        the ending offset + 1
    returns     the converted string (not a copy)

(nstring-downcase <str> &key :start :end)  CONVERT TO LOWERCASE
    <str>       the string
    :start      the starting offset
    :end        the ending offset + 1
    returns     the converted string (not a copy)

(strcat <expr>...)  CONCATENATE STRINGS
    <expr>      the strings to concatenate
    returns     the result of concatenating the strings

(subseq <string> <start> [<end>]) EXTRACT A SUBSTRING
    <string>    the string
    <start>     the starting position (zero origin)
    <end>       the ending position + 1 (defaults to end)
    returns     substring between <start> and <end>

(string<  &key :start1 :end1 :start2 :end2)
(string<=  &key :start1 :end1 :start2 :end2)
(string= <str1>  &key :start1 :end1 :start2 :end2)
(string/= <str1>  &key :start1 :end1 :start2 :end2)
(string>= <str1>  &key :start1 :end1 :start2 :end2)
(string> <str1>  &key :start1 :end1 :start2 :end2)
    <str1>      the first string to compare
    <str2>      the second string to compare
    :start1     first substring starting offset
    :end1       first substring ending offset + 1
    :start2     second substring starting offset
    :end2       second substring ending offset + 1
    returns     t if predicate is true, nil otherwise
  Note: case is significant with these comparison functions.

(string-lessp <str1>  &key :start1 :end1 :start2 :end2)
(string-not-greaterp <str1>  &key :start1 :end1 :start2 :end2)
(string-equalp <str1>  &key :start1 :end1 :start2 :end2)
(string-not-equalp <str1>  &key :start1 :end1 :start2 :end2)
(string-not-lessp <str1>  &key :start1 :end1 :start2 :end2)
(string-greaterp <str1>  &key :start1 :end1 :start2 :end2)
    <str1>      the first string to compare
    <str2>      the second string to compare
    :start1     first substring starting offset
    :end1       first substring ending offset + 1
    :start2     second substring starting offset
    :end2       second substring ending offset + 1
    returns     t if predicate is true, nil otherwise
  Note: case is not significant with these comparison functions.