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


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