UPPER-CASE Function

The UPPER-CASE function returns a character string that is the same length as argument-1 with each lowercase letter replaced by the corresponding uppercase letter. The type of this function is alphanumeric.

Usage

FUNCTION UPPER-CASE (argument-1)

Parameter

argument-1 Must be class numeric or alphanumeric and must be at least one character in length.

Returned Values

  1. The same character string as argument-1 is returned, except that each lowercase letter is replaced by the corresponding uppercase letter.
  2. The character string returned has the same length as argument-1.
  3. This function only translates characters with a numeric value of 0-128. Anything above that (such as é, with a value of 130) must be mapped to its associated upper- or lower-case character using the configuration variable UPPER-LOWER-MAP.
    Note: This function is similar to the library routine C$TOUPPER except that the original data is not modified, and the entire string is converted.
  4. The returned value can be reference modified. For example: 
    MOVE FUNCTION UPPER-CASE(FILE-NAME)(1:4) TO TMP-STRING.
Parent topic: Appendix F. Intrinsic Functions