Rational Developer for System z
COBOL for Windows, Version 7.5, Language Reference


UPPER-CASE

The UPPER-CASE function returns a character string that contains the characters in the argument with each lowercase letter replaced by the corresponding uppercase letter.

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

Argument type Function type
Alphabetic Alphanumeric
Alphanumeric Alphanumeric
National National

Format
Read syntax diagramSkip visual syntax diagram>>-FUNCTION UPPER-CASE--(--argument-1--)-----------------------><
 
argument-1
Must be class alphabetic, alphanumeric, or national and must be at least one character position in length.

The same character string as argument-1 is returned, except that each lowercase letter is replaced by the corresponding uppercase letter.

The conversion of characters from lowercase to uppercase is based on the specification of character attributes in the applicable runtime locale.

For some locales, the conversion of characters from lowercase to uppercase can result in a character string with a different length than the length of argument-1. This can occur for all possible arguments type. For alphabetic and alphanumeric arguments that consist solely of uppercase Latin letters A through Z, lowercase Latin letters a through z, and digits 0 through 9, the length of the returned character string is the same as the length of argument-1.


Terms of use | Feedback

Copyright IBM Corporation 1996, 2008.
This information center is powered by Eclipse technology. (http://www.eclipse.org)