ILE COBOL Language Reference


UPPER-CASE

The UPPER-CASE function returns a character string that is the same length as the argument specified, with each lowercase letter replaced by the corresponding uppercase 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 UPPER-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 lowercase letter is replaced by the corresponding uppercase 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 character string returned has the same length as argument-1.

Related Information


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