LOWER-CASE Function

The LOWER-CASE function returns a character string that is the same length as argument-1 with each uppercase letter replaced by the corresponding lowercase letter. The type of this function is alphanumeric.

Usage

FUNCTION LOWER-CASE (argument-1)

Parameter

argument-1 Must be class alphabetic or alphanumeric, and must be at least one character in length.

Returned Values

  1. The same character string as argument-1 is returned, except that each uppercase letter is replaced by the corresponding lowercase letter.
  2. The character string returned has the same length as argument-1.
  3. If the computer character set does not include lowercase letters, no changes take place in the character string.
  4. This function only translates characters with a numeric value of 0-128. Anything above that (such as é with a value of 130) must be mapped to its associated upper- or lower-case character using the configuration variable UPPER-LOWER-MAP.
    Note: This function is similar to the library routine C$TOLOWER except that the original data is not modified, and the entire string is converted.
  5. The returned value can be reference modified. For example:

    MOVE FUNCTION LOWER-CASE(FILE-NAME)(1:4) TO TMP-STRING.

Parent topic: Appendix F. Intrinsic Functions