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-upcase

string-upcase

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

SYNTAX

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

DESCRIPTION

The STRING-UPCASE function takes a string argument and returns a new string that has been made upper 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-UPCASE 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-upcase "ABcd+-12&[")            ; returns "ABCD+-&["
(string-upcase "abcdefgh"               ;
                 :start 2 :end 4)       ; returns "abCDefgh"
                                        ;
(setq mystr "ABcdEFgh")                 ; set up variable
(string-upcase mystr)                   ; returns "ABCDEFGH"
(print mystr)                           ; prints  "ABcdEFgh"


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