LOWER-CASE

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

The function type depends on the argument types, as follows:

Argument Type Function Type
Alphabetic Alphanumeric
Alphanumeric Alphanumeric
DBCS¹ DBCS¹
Note: ¹ IBM Extension
Read syntax diagramSkip visual syntax diagram
Format

>>-FUNCTION LOWER-CASE--(--argument-1--)-----------------------><

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

Argument-1 can be DBCS or national.

End of IBM Extension

The same character string as argument-1 is returned, except that each uppercase letter is replaced by the corresponding lowercase letter. A program collating sequence or code page does not affect the returned value.

IBM Extension

If argument-1 is DBCS, the DBCS value is not affected. If argument-1 is a mixed literal, only the single byte portions of the literal are affected.

End of IBM Extension

The returned character string has the same length as argument-1.

Related Information