upper - convert to upper case

SYNOPSIS

<upper $str [$mode]>

DESCRIPTION
The upper function converts each $str string value to all upper-case letters (non-alphabetic characters are unchanged), according to the corresponding $mode value, which is a string-folding mode in the same format as the stringcomparemode setting of apicp (here). The default if empty or unspecified is the current apicp stringcomparemode setting, but upper-case.

DIAGNOSTICS
upper returns its $str parameter with all values converted to upper case characters, according to stringcomparemode $mode.

EXAMPLE

<upper "Whisper!">

The return value in $ret would be "WHISPER!".

CAVEATS
The upper function was added Oct. 24 1996. The $mode argument, or usage of stringcomparemode, was added in version 6.

SEE ALSO
lower, strfold