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

STR_ISLOWER

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

Syntax

STR_ISLOWER(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 lowercase letters. "N" = The string does either not include letters or at least one uppercase letter.

Comments

This script function checks whether all characters of a specified string are written in lowercase 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 uppercase letter or no letters at all. "Y" will be returned when all letters of the string are lowercase letters.

Examples

The following example checks whether the archive key of the own object only includes lowercase letters.

:SET &VAR# = GET_ATT(ARCHIVE_KEY1)
:SET &CHECK# = STR_ISLOWER(&VAR#)
:IF &CHECK# EQ "Y"
: P "ArchiveKey1 only includes lowercase letters."
:ENDIF