STR_ISUPPER

Script Function: Checks whether the characters of a certain string are written in uppercase letters.

Syntax

STR_ISUPPER (String)

Syntax

Description/Format

String

An alpha-numeric string.

Format: script literal or script variable


Return Codes

"Y" = All characters of the string are written in uppercase letters.
"N" = The string does either not include letters or at least one lowercase letter.

This script function checks whether all characters of a specified string are written in uppercase letters. Special characters and numbers that might be used within the string are ignored. You can either define the string directly (by using single or double quotes) or use a script variable for this purpose.

"N" will be returned when the string includes at least one lowercase letter or no letters at all. "Y" will be returned when all letters of the string are uppercase letters.

Examples

The following example reads an entry of a VARA object and verifies that it is written in uppercase letters.

:SET &VAR#GET_VAR(VARA.DB, "TEST", 1)
:SET &CHECK# = STR_ISUPPER(&VAR#)
:IF &CHECK# EQ "Y"
P "STR_ISUPPER(&VAR#) = Y"
:ENDIF

See also: