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
DBCS1 DBCS1
Note: 1 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

IBM Extension Argument-1 can be DBCS or national. End of IBM Extension

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

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

End of IBM Extension

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

Related Information