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

Format

argument-1: Must be of class alphabetic, alphanumeric, national, or UTF-8 and must be at least one character position in length.

Note: If argument-1 is of the alphanumeric class, it must not contain UTF-8 encoded data.

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

If argument-1 is alphabetic or alphanumeric, the lowercase letters 'a' through 'z' are replaced by the corresponding uppercase letters 'A' through 'Z', where the range of 'a' through 'z' and the range of 'A' through 'Z' are as shown in EBCDIC collating sequence, regardless of the code page in effect.

If argument-1 is national or UTF-8, each lowercase letter is replaced by its corresponding uppercase letter based on the specification given in the Unicode database UnicodeData.txt, available from the Unicode Consortium at www.unicode.org/.

If argument-1 is not of class UTF-8, the character string returned has the same length as argument-1. For UTF-8 arguments, the returned string may have a different byte length than the byte length of argument-1.