lower - convert to lower case

SYNOPSIS

<lower $str [$mode]>

DESCRIPTION
The lower function converts each $str string value to all lower-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 lower-case.

DIAGNOSTICS
lower returns its $str parameter with all values converted to lower case characters. $mode is an optional stringcomparemode value.

EXAMPLE

<lower "Whisper!">

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

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

SEE ALSO
upper, strfold