Structural Informatics Group (SIG) logo
Home | Projects | Demos | Downloads | Publications | Local Info | About Us | New site
Go to the first, previous, next, last section, table of contents.

string-downcase

string-downcase

type: function (subr) 
location: built-in
source file: xlstr.c
Common LISP compatible: yes
supported on: all machines

SYNTAX

(string-downcase <string> [ { :start | :end }  ] ... )
        <string>        -       a string expression
        <offset>        -       an optional integer expression (for a keyword)

DESCRIPTION

The STRING-DOWNCASE function takes a string argument and returns a new string that has been made lower case.

The keyword arguments allow for accessing substrings within <string>. The keyword arguments require a keyword (:START or :END) first and a single integer expression second. The :START keyword specifies the starting offset for the STRING-DOWNCASE operation on <string>. A value of 0 starts the string at the beginning (no offset). The :END keyword specifies the end offset for the operation on <string>.

EXAMPLES

(string-downcase "ABcd+-12&[")          ; returns "abcd+-&["
(string-downcase "ABCDEFGH"             ;
                 :start 2 :end 4)       ; returns "ABcdEFGH"
                                        ;
(setq mystr "ABcdEFgh")                 ; set up variable
(string-downcase mystr)                 ; returns "abcdefgh"
(print mystr)                           ; prints  "ABcdEFgh"


Go to the first, previous, next, last section, table of contents.