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 diagramFUNCTION UPPER-CASE (argument-1 )
argument-1
Must be of class alphabetic, alphanumeric, or national 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, 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/ .

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