Automation Engine Script Guide > Ordered by Function > Strings > STR_ISUPPER

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.

Comments

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