ILE COBOL Language Reference


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
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


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]