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


Copyright © Thunderstone Software     Last updated: Oct 24 2023
Copyright © 2024 Thunderstone Software LLC. All rights reserved.